Spring Boot Fat JAR中Spring Cloud Gateway的HTTP日志配置问题

一、核心配置调整 #

1. 启用访问日志的可靠方式 #

除了JVM启动参数-Dreactor.netty.http.server.accessLogEnabled=true，更推荐在application.properties中直接配置：

spring.netty.http.server.access-log-enabled=true

或通过代码自定义Netty服务器配置，确保设置生效：

import org.springframework.boot.web.embedded.netty.NettyReactiveWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class NettyConfig {
    @Bean
    public WebServerFactoryCustomizer<NettyReactiveWebServerFactory> nettyAccessLogCustomizer() {
        return factory -> factory.addServerCustomizers(httpServer -> httpServer.accessLog(true));
    }
}

2. 配置Log4j2日志输出 #

Netty访问日志默认以INFO级别输出，需在配置中开启对应日志级别并指定输出目标：

• 若用application.properties：

logging.level.reactor.netty.http.server=INFO

• 若用log4j2.xml，需添加专属Logger配置：

<Logger name="reactor.netty.http.server" level="INFO" additivity="false">
    <AppenderRef ref="ConsoleAppender"/> <!-- 替换为你的控制台输出Appender名称 -->
    <AppenderRef ref="FileAppender"/> <!-- 替换为你的文件输出Appender名称 -->
</Logger>

二、依赖与构建优化 #

1. 改用Spring Boot官方Fat Jar构建 #

你的build.gradle中自定义了jar任务构建Fat Jar，建议替换为Spring Boot插件自带的bootJar任务，它会自动处理依赖打包、主类配置等细节，避免手动配置遗漏：

• 删除jar.enabled=false和自定义的jar任务块
• 执行./gradlew bootJar构建Fat Jar，产物位于build/libs目录

2. 确保日志依赖无冲突 #

保持当前runtimeOnly中的排除配置，避免Spring默认日志框架干扰：

exclude group:'org.springframework.boot' , module: 'spring-boot-starter-logging'
exclude group:'org.slf4j' , module: 'log4j-over-slf4j'
exclude group:'org.apache.logging.log4j' , module: 'log4j-to-slf4j'

Spring Boot 2.7.16已自动管理reactor-netty与netty-common的版本兼容性，无需手动指定。

三、验证启动参数传递 #

若仍使用JVM参数方式启用访问日志，需确认启动命令中参数正确传递：

java -Dreactor.netty.http.server.accessLogEnabled=true -jar api-gateway-{RELEASE_NAME}.jar

避免启动脚本中参数被截断或未正确传递到JVM进程。

内容的提问来源于stack exchange，提问作者Bert Galbreath