log4j2/logback 日志配置无法识别启动传入的JVM程序参数
问题本质
你遇到的日志文件名始终命中默认值的问题,核心是原生Logback的XML配置和Spring Boot的日志加载流程存在时机不匹配:
- 原生Logback用
${sys:xxx}读取属性时,会在XML文件加载完成的瞬间同步解析值 - 你通过yaml的
logging.config指定自定义logback文件的加载动作,发生在Spring Boot的早期初始化阶段,部分版本下Logback的解析流程早于系统属性上下文的桥接完成,根本没索引到-D参数设置的JVM系统属性,自然就只能走到noPort的默认值分支 - 顺带排个容易踩的低级坑:如果启动命令里把
-D参数放到-jar指令的后面,这些参数只会传给应用main方法的入参,不会写入JVM全局系统属性,再怎么配置都读不到。你当前的命令里参数位置是对的,直接排除这个问题就行。
解决方法
不要直接用Logback原生的${sys:xxx}写法,换成Spring Boot官方提供的<springProperty>标签来读取参数。这个标签是Spring专门给Logback做的扩展,会等Spring Environment把所有属性源(JVM参数、yaml配置、profile配置)全部加载完成之后,再把对应的值注入到Logback上下文里,从根源上规避时机不匹配的问题。
具体修改步骤:
- 打开你的
fileAppender.xml,在<configuration>标签下新增需要读取的属性定义,比如要读server.port:
<configuration> <!-- 从Spring Environment读server.port,注入为Logback上下文属性logPort,默认值noPort --> <springProperty scope="context" name="logPort" source="server.port" defaultValue="noPort"/> <!-- 要读启动时传的remoteMapIp参数同理,新增一行定义就行 --> <springProperty scope="context" name="remoteMapIp" source="remoteMapIp" defaultValue="unknown"/> <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"> <encoder> <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level - %msg%n</pattern> </encoder> <!-- 把原来的${sys:server.port:-noPort}替换为定义好的${logPort} --> <file>logs/ttsis-rows-${logPort}.log</file> <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"> <cleanHistoryOnStart>false</cleanHistoryOnStart> <fileNamePattern>ttsis-rows-${logPort}.log.%d{yyyy-MM-dd}.%i.gz</fileNamePattern> <maxFileSize>20MB</maxFileSize> <maxHistory>30</maxHistory> </rollingPolicy> </appender> <root level="INFO"> <appender-ref ref="FILE"/> </root> </configuration>
容易漏的排查点
- 检查激活的tt-test.yaml配置里,有没有Spring Boot内置的日志配置(比如
logging.file.name、logging.file.path),这类配置会自动注入Logback上下文,可能和你自定义的appender路径产生冲突 - 如果改完还是读不到值,临时加一行启动日志,打印
System.getProperty("server.port")确认参数真的被写入了JVM系统属性 - 注意
<springProperty>的source字段要和参数名完全一致,大小写不对也会读不到,命中默认值
内容的提问来源于stack exchange,提问作者Alperen Üretmen
相关产品推荐
相关产品推荐

