Tomcat 9部署Spring Boot WAR时日志配置路径错误排查求助
结合Logback和Spring Boot的日志初始化逻辑,核心原因如下:
系统属性/环境变量被显式指定
Logback原生会读取logback.configurationFile系统属性,Spring Boot扩展支持logging.config系统属性/环境变量,两者都会优先加载指定路径的日志配置文件。如果生成logging_config.ini的工具不小心设置了这两个参数中的任意一个指向该文件,Spring Boot启动时就会尝试加载它。即便你重命名了文件,只要系统属性未清除,Tomcat仍会按指定路径查找,导致报错。Logback自动扫描路径命中该文件
Logback的ContextInitializer会在默认路径(如Tomcat工作目录、应用classpath根目录)下扫描日志配置文件。虽然Logback默认仅识别.xml/.groovy/.yml/.yaml后缀,但如果logging_config.ini所在目录被纳入扫描范围,且存在异常配置触发了对该文件的加载(比如工具注入的自定义扫描逻辑),也会引发这个问题。Tomcat启动配置的隐性引用
除了catalina.sh,Tomcat的启动参数还可能来自setenv.sh(Linux)、setenv.bat(Windows)或catalina.properties等文件。如果这些文件中添加了指向logging_config.ini的JVM参数(如-Dlogging.config=/myPath/logging_config.ini),就会被Spring Boot读取并尝试加载。生成工具的残留配置影响
生成logging_config.ini的工具可能修改了Tomcat的环境变量、JVM启动参数,甚至在应用classpath中注入了相关配置。这类修改不会直接体现在catalina.sh或logging.properties中,需要排查Tomcat整个启动环境链。
排查建议
- 检查系统环境变量:执行
echo $logback.configurationFile和echo $LOGGING_CONFIG,确认是否有指向该.ini文件的配置。 - 查看Tomcat的
setenv.sh/setenv.bat文件,检查是否添加了相关JVM参数。 - 检查Tomcat的
catalina.properties,确认未设置相关系统属性。 - 查看Tomcat启动时的完整JVM参数:Linux下执行
ps aux | grep tomcat,查看进程参数中是否包含-Dlogging.config或-Dlogback.configurationFile。
内容的提问来源于stack exchange,提问作者Ulfnir

