Docker容器部署JAR应用时Logback日志文件未生成问题排查

核心诱因 #

• Logback配置缺失关键项
  • 你的RollingFileAppender仅配置了滚动归档的fileNamePattern，没有指定<file>节点声明实时写入的活跃日志文件路径。Windows环境下Logback对该缺省配置兼容性较好，会自动推导路径创建目录，但Linux环境下多数版本不会主动处理多级不存在的路径，直接导致文件创建失败。
  • 未开启父目录自动创建能力：Logback 1.2.9及以上版本默认关闭不存在父目录的自动创建逻辑，你配置的logs/yyyy-MM-dd/是两级嵌套目录，没有显式开启开关的话不会递归创建目录。
  • FILE appender绑定范围过窄：你只把FILE appender绑定到两个DEBUG级别的自定义logger上，root日志器仅输出到控制台。如果这两个logger对应的代码逻辑没有触发（比如切面未生效、没有执行JDBC操作），FILE appender根本不会完成初始化，自然不会生成任何目录和文件。
• 容器环境配置问题
  • 当前Dockerfile没有提前创建logs目录，也没有做宿主机挂载，如果Logback启动时没有触发写操作，不会主动生成目录。
  • 虽然你进入容器时看到是root用户，但如果启动容器时指定了非root运行用户，而/app目录默认是root属主，非root用户无写入权限也会导致日志创建失败。
• 日志级别配置问题
  • 绑定FILE appender的两个logger均为DEBUG级别，如果应用配置中覆盖了对应包的日志级别为INFO及以上，就不会有日志写入FILE appender。

排查与修复步骤 #

1. 先验证目录权限与写入逻辑
   进入容器后手动创建日志目录并开放权限，之后触发一次对应类的日志输出（比如执行数据库操作触发JdbcTemplate打日志），观察是否生成日志文件。如果能生成，说明是目录自动创建配置的问题。
   执行命令：

   mkdir -p /app/logs && chmod 777 /app/logs
   

2. 修正Logback配置
   给FILE appender补上缺失的活跃日志文件配置、父目录自动创建开关，修正后配置参考：

   <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
       <!-- 实时写入的活跃日志文件路径 -->
       <file>logs/app.log</file>
       <!-- 开启不存在父目录自动创建，Logback 1.2.9+版本支持 -->
       <createParentDirectories>true</createParentDirectories>
       <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
           <fileNamePattern>logs/%d{yyyy-MM-dd}/slf4jlogback.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
           <maxHistory>2</maxHistory>
           <maxFileSize>10MB</maxFileSize>
           <totalSizeCap>100MB</totalSizeCap>
       </rollingPolicy>
       <encoder>
           <pattern>%d{dd.MM.yyyy HH:mm:ss.SSS} [%thread] %-5level  %logger{36} - %msg%n</pattern>
       </encoder>
   </appender>
   

3. 验证日志触发逻辑
   临时给root logger加上FILE appender引用，重启应用看是否生成日志，排除是appender绑定范围过窄、无日志触发的问题：

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

   如果加上后日志正常生成，说明之前绑定的两个logger没有实际输出，需要检查切面是否生效、JDBC操作是否正常执行、日志级别是否被其他配置覆盖。
4. 优化Dockerfile配置
   在构建镜像时提前创建日志目录并分配权限，避免运行时权限问题，修改后参考：

   FROM adoptopenjdk/openjdk11:alpine-jre
   ARG JAR_FILE=/build/libs/*.jar
   WORKDIR /app
   # 提前创建日志目录
   RUN mkdir -p /app/logs && chmod 777 /app/logs
   COPY ${JAR_FILE} app.jar
   ENTRYPOINT ["java","-jar","app.jar"]
   

5. 检查启动报错
   启动容器时留意控制台输出，是否有Logback相关的FileNotFoundException、权限拒绝类报错，根据报错信息定向处理即可。

容器化部署建议将日志目录挂载到宿主机，避免容器重启后日志丢失，启动时添加挂载参数即可：docker run -v 宿主机日志绝对路径:/app/logs 镜像名

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