Spring Boot WebFlux项目中Logbook无法生成日志求助

1. 确认日志框架配置是否生效 #

你已经设置了logbook.write.category: logbook.log和level: DEBUG，但需要确保日志框架（如Logback）已配置该日志类别的输出规则。如果缺少这一步，日志框架会直接忽略Logbook的DEBUG级日志。

比如在logback-spring.xml中添加：

<logger name="logbook.log" level="DEBUG" additivity="false">
    <appender-ref ref="CONSOLE"/>
    <!-- 如需输出到文件，追加文件appender配置 -->
    <appender-ref ref="FILE"/>
</logger>

2. 检查依赖兼容性与完整性 #

• 虽然logbook-spring-boot-webflux-autoconfigure会自动引入核心依赖，但可以显式添加logbook-core确保依赖链完整：

<dependency>
    <groupId>org.zalando</groupId>
    <artifactId>logbook-core</artifactId>
    <version>3.9.0</version>
</dependency>

• 确认Spring Boot版本与Logbook兼容：Spring Boot 3.x对应Logbook 3.x（你的版本匹配），如果是Spring Boot 2.x则需要降级Logbook到2.x版本。

3. 显式启用Logbook #

虽然默认启用，但显式配置可避免自动配置失效：

logbook:
  enabled: true

4. 排查请求是否被过滤排除 #

你的配置中排除了/swagger、/api-docs、/actuator路径，以及application/octet-stream类型的请求。测试时要调用未被排除的接口（如/api/v1/test），避免测试请求刚好被过滤。

5. 验证Logbook Bean加载状态 #

添加简单配置类，检查核心Bean是否正常创建：

import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Bean;
import org.zalando.logbook.Logbook;

@Configuration
public class LogbookConfig {
    @Bean
    public Logbook logbook(Logbook.Builder builder) {
        return builder.build();
    }
}

如果Bean能正常初始化，说明自动配置已生效；若初始化失败，说明依赖或基础配置存在问题。

6. 调整WebFlux过滤器顺序 #

WebFlux中过滤器顺序会影响日志捕获，可设置让Logbook过滤器优先执行：

logbook:
  filter:
    order: -100 # 数值越小，执行顺序越靠前

7. 用极简配置测试 #

先简化application.yml，去掉过滤、混淆等复杂配置，验证基础功能是否正常：

logbook:
  enabled: true
  format: json
  write:
    level: DEBUG
    category: logbook.log

如果极简配置能输出日志，再逐步添加原有配置，定位具体哪项配置导致问题。

内容的提问来源于stack exchange，提问作者fabio trabattoni