Spring Boot项目Logback配置后异常日志未写入文件仅输出stdout问题

根因与修复步骤 #

• 缺失日志级别配置
  你的配置中<root>标签未显式声明日志级别，虽然Spring Boot默认root级别为INFO，但层级继承异常可能导致ERROR级别的异常事件未被路由到FILE appender。修复方式为给root标签添加级别属性：

  <root level="INFO">
      <appender-ref ref="STDOUT" />
      <appender-ref ref="FILE" />
  </root>
  

• LogstashEncoder异常字段易被忽略
  FILE appender使用的LogstashEncoder默认会将异常堆栈信息单独输出到JSON的stack_trace字段，不会合并到message字段中，如果你只检索message字段会误以为没有异常输出。你可以直接检查日志文件的JSON结构确认是否存在stack_trace字段；如果需要和STDOUT一样将异常栈合并到日志正文，可在LogstashEncoder中添加以下配置：

  <throwableConverter class="net.logstash.logback.stacktrace.ShortenedThrowableConverter">
      <maxDepthPerThrowable>30</maxDepthPerThrowable>
      <rootCauseFirst>true</rootCauseFirst>
  </throwableConverter>
  

• 日志刷盘延迟问题
  RollingFileAppender默认启用缓冲，异常产生后可能暂存在内存未刷入磁盘，可在FILE appender配置中添加<immediateFlush>true</immediateFlush>强制每次日志事件立刻写盘。
• 环境变量与权限问题
  你配置的日志路径使用了${MY_POD_NAMESPACE}、${HOSTNAME}环境变量，若变量解析失败会导致路径异常，可先替换为固定本地路径测试；同时需确认运行程序的用户对/var/log/app/backend-business-workflow目录有读写权限，可执行命令chmod -R 755 /var/log/app/backend-business-workflow授权。

验证方法 #

新增测试代码手动输出异常：

try {
    throw new RuntimeException("测试异常");
} catch (Exception e) {
    log.error("出现业务异常", e);
}

执行后检查日志文件的JSON内容是否包含异常栈信息即可。 #

内容的提问来源于stack exchange，提问作者dead programmer