Feign的请求和响应日志方式是什么

Feign 是一个声明式的 Web 服务客户端，它使得编写 Web 服务客户端变得更加简单。Feign 通过注解的方式来定义和实现 HTTP 请求，极大地简化了与 RESTful 服务的交互。在实际开发中，调试和监控 HTTP 请求和响应是非常重要的，因此 Feign 提供了多种方式来记录请求和响应的日志。

1. Feign 日志级别

Feign 的日志级别可以通过配置来设置，通常有以下几种级别：

• NONE：不记录任何日志（默认级别）。
• BASIC：仅记录请求方法、URL 和响应状态码以及执行时间。
• HEADERS：记录请求和响应的头信息，以及 BASIC 级别的信息。
• FULL：记录请求和响应的头信息、正文以及元数据。

2. 配置 Feign 日志

要启用 Feign 的日志功能，首先需要在 Feign 客户端接口上指定日志级别。可以通过 @FeignClient 注解的 configuration 属性来指定配置类，或者在配置文件中进行全局配置。

2.1 通过配置类启用日志

首先，创建一个配置类，并在其中定义一个 Logger.Level 的 Bean：

import feign.Logger;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class FeignConfig {

    @Bean
    Logger.Level feignLoggerLevel() {
        return Logger.Level.FULL;
    }
}

然后，在 Feign 客户端接口上指定该配置类：

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient(name = "example-service", configuration = FeignConfig.class)
public interface ExampleServiceClient {

    @GetMapping("/example")
    String getExample();
}

2.2 通过配置文件启用日志

如果你不想创建配置类，也可以通过配置文件来启用日志。在 application.yml 或 application.properties 中添加以下配置：

logging:
  level:
    com.example.ExampleServiceClient: DEBUG

或者在 application.properties 中：

logging.level.com.example.ExampleServiceClient=DEBUG

3. 日志输出

启用日志后，Feign 会将请求和响应的详细信息输出到日志中。以下是一个 FULL 日志级别的输出示例：

2023-10-01 12:00:00.000 DEBUG 12345 --- [nio-8080-exec-1] c.e.ExampleServiceClient                : [ExampleServiceClient#getExample] ---> GET http://example-service/example HTTP/1.1
2023-10-01 12:00:00.001 DEBUG 12345 --- [nio-8080-exec-1] c.e.ExampleServiceClient                : [ExampleServiceClient#getExample] ---> END HTTP (0-byte body)
2023-10-01 12:00:00.100 DEBUG 12345 --- [nio-8080-exec-1] c.e.ExampleServiceClient                : [ExampleServiceClient#getExample] <--- HTTP/1.1 200 OK (99ms)
2023-10-01 12:00:00.101 DEBUG 12345 --- [nio-8080-exec-1] c.e.ExampleServiceClient                : [ExampleServiceClient#getExample] content-length: 13
2023-10-01 12:00:00.102 DEBUG 12345 --- [nio-8080-exec-1] c.e.ExampleServiceClient                : [ExampleServiceClient#getExample] content-type: text/plain;charset=UTF-8
2023-10-01 12:00:00.103 DEBUG 12345 --- [nio-8080-exec-1] c.e.ExampleServiceClient                : [ExampleServiceClient#getExample] 
2023-10-01 12:00:00.104 DEBUG 12345 --- [nio-8080-exec-1] c.e.ExampleServiceClient                : [ExampleServiceClient#getExample] Hello, World!
2023-10-01 12:00:00.105 DEBUG 12345 --- [nio-8080-exec-1] c.e.ExampleServiceClient                : [ExampleServiceClient#getExample] <--- END HTTP (13-byte body)

在这个示例中，日志详细记录了请求的 URL、方法、头信息、响应状态码、响应头以及响应正文。

4. 自定义日志

如果你需要更复杂的日志记录逻辑，可以通过实现 feign.Logger 接口来自定义日志记录器。以下是一个简单的自定义日志记录器示例：

import feign.Logger;
import feign.Request;
import feign.Response;

import java.io.IOException;

public class CustomFeignLogger extends Logger {

    @Override
    protected void log(String configKey, String format, Object... args) {
        System.out.printf(methodTag(configKey) + format + "%n", args);
    }

    @Override
    protected void logRequest(String configKey, Level logLevel, Request request) {
        System.out.println("Request: " + request.toString());
    }

    @Override
    protected Response logAndRebufferResponse(String configKey, Level logLevel, Response response, long elapsedTime) throws IOException {
        System.out.println("Response: " + response.toString());
        return response;
    }
}

然后，在配置类中使用这个自定义日志记录器：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class FeignConfig {

    @Bean
    Logger customFeignLogger() {
        return new CustomFeignLogger();
    }
}

5. 总结

Feign 提供了灵活的日志记录机制，可以帮助开发者在调试和监控 HTTP 请求和响应时更加方便。通过配置日志级别或自定义日志记录器，开发者可以根据实际需求来记录不同粒度的日志信息。合理使用 Feign 的日志功能，可以大大提高开发和调试效率。