ECS(Fargate)部署SpringBoot时Controller debug日志未输出到CloudWatch

你遇到的日志输出差异核心是日志初始化时机和默认配置规则共同导致的：

• 写在SpringApplication.run(Application.class, args)之前的那行DEBUG日志，打印时Spring Boot还未完成自身日志系统的初始化，此时SLF4J直接使用绑定的日志实现（默认是Logback）的默认配置，默认全局日志级别为DEBUG，因此这行日志可以正常输出到标准输出，被CloudWatch采集到。
• 当SpringApplication.run执行过程中，Spring Boot会重置整套日志配置：默认root日志级别为INFO，自定义业务包的日志级别默认继承root级别，也就是INFO。Controller层属于自定义业务代码，输出DEBUG日志时会被日志框架直接过滤，根本不会输出到标准输出流，自然无法在CloudWatch中查询到。
• 额外说明：很多人误以为配置debug: true就能输出所有DEBUG日志，实际上这个配置只会开启Spring核心框架类的DEBUG日志，不会修改自定义业务包的日志级别。

• 第一步：显式配置业务包日志级别
  在Spring Boot配置文件（application.yml/application.properties）中，针对Controller所在的业务包单独设置DEBUG级别，示例配置如下：
  application.yml配置示例：

  logging:
    level:
      root: INFO
      # 将下方包路径替换为你项目中Controller实际所在的包路径
      com.your.biz.controller: DEBUG
  

  application.properties配置示例：

  logging.level.root=INFO
  # 将下方包路径替换为你项目中Controller实际所在的包路径
  logging.level.com.your.biz.controller=DEBUG
  

  配置完成后重新构建镜像、更新ECS任务，调用对应接口触发日志打印，验证输出是否正常。
• 第二步：本地验证日志输出逻辑
  用和线上一致的配置在本地启动应用，调用对应Controller接口，先确认本地控制台可以正常打印目标DEBUG日志，排查低级错误：比如日志打印的代码分支没有被实际触发、Logger对象导入错误、自定义日志配置文件（logback-spring.xml/log4j2.xml等）覆盖了包级别配置。
• 第三步：排查日志采集链路配置
  如果本地可以正常输出DEBUG日志，但Fargate环境依然看不到，依次检查两个环节：
  1. 检查ECS任务定义中的awslogs日志驱动配置，确认没有配置额外的日志过滤规则，任务的IAM角色具备CloudWatch日志写入权限
  2. 检查对应CloudWatch日志组的订阅过滤器、指标过滤器，确认没有配置规则过滤掉DEBUG级别的日志

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