Spring Boot 2.7.2部署外部Tomcat，日志文件创建但无内容写入

一、先排查application.properties配置问题 #

• 确认日志配置前缀与范围：Spring Boot部署外部Tomcat时，需用logging.前缀配置，且要明确指定Controller所在包的日志级别，比如logging.level.com.yourproject.controller=DEBUG。仅配置logging.level.root=INFO可能无法覆盖子包的级别限制，导致低级别日志被过滤。
• 检查日志文件权限：即使文件已创建，也要确认Tomcat进程对该文件有写入权限。Linux下可查看文件所属用户组是否为tomcat，Windows下需确保Tomcat服务账户有写入权限，权限不足会导致日志无法写入。
• 排查自定义日志配置冲突：如果项目中存在logback.xml、log4j2.xml等自定义配置文件，会直接覆盖application.properties的设置。需检查这些文件是否正确配置了Appender路径、日志级别，是否开启了对应级别的输出。

二、再排查Controller代码问题 #

• 验证Logger注入正确性：必须使用Slf4j标准Logger实现，避免混用其他日志框架。正确代码示例：

  import org.slf4j.Logger;
  import org.slf4j.LoggerFactory;
  import org.springframework.web.bind.annotation.GetMapping;
  import org.springframework.web.bind.annotation.RestController;
  
  @RestController
  public class LoggingController {
      private static final Logger logger = LoggerFactory.getLogger(LoggingController.class);
  
      @GetMapping("/applogging")
      public String testLogging() {
          logger.error("Error级别日志");
          logger.warn("Warn级别日志");
          logger.info("Info级别日志");
          logger.debug("Debug级别日志");
          return "日志测试完成";
      }
  }
  

• 确认接口访问路径正确性：外部Tomcat部署WAR包时，接口完整路径为http://<Tomcat地址>:<端口>/<WAR包上下文路径>/applogging。比如WAR包名为myapp.war，则上下文路径为/myapp，需确保访问的是完整路径，否则Controller方法不会执行。
• 检查拦截器/过滤器拦截：若项目有自定义拦截器或过滤器，需确认它们未阻止请求进入Controller方法，比如是否在拦截逻辑中直接返回响应，导致日志代码未执行。

三、最后排查外部Tomcat影响 #

• 调整Tomcat全局日志级别：Tomcat自身的conf/logging.properties配置可能过滤Spring Boot的日志。可添加配置org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/<WAR上下文路径>].level = FINE，放开对应应用的日志级别限制。
• 确保日志依赖无冲突：如果使用自定义日志框架（如Log4j2），需在pom.xml中排除Spring Boot默认的Logging依赖，避免与Tomcat自带日志组件冲突。示例：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-logging</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-log4j2</artifactId>
  </dependency>
  

快速排查步骤 #

1. 在Controller方法中添加System.out.println("进入接口")，访问后查看Tomcat的catalina.out控制台，确认方法是否被执行。
2. 临时将日志级别调至DEBUG，观察是否有日志输出，排查级别过滤问题。
3. 若有自定义日志配置文件，先临时移除，使用application.properties默认配置测试，确认是否为配置文件冲突。

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