Spring Boot 2控制台颜色配置：如何将异常日志从灰色改为红色

问题核心成因：Logback控制台输出的异常堆栈部分未绑定颜色映射规则，导致本该标识为红色的ERROR级异常内容，退回为默认灰色显示。可按以下步骤完成配置：

前置环境校验 #

• 确认运行控制台已开启ANSI颜色支持：
  • IntelliJ IDEA：在设置 -> 编辑器 -> 颜色方案 -> 控制台字体中勾选颜色方案启用选项，同时通过注册表（快捷键Ctrl+Shift+A搜索Registry）确认ide.console.ansi.color.enable为开启状态
  • 终端环境：Windows 需在终端属性中启用VT100模拟支持，Mac/Linux 终端默认原生支持ANSI颜色

核心Logback配置调整 #

Spring Boot 默认日志格式中，负责输出异常堆栈的%wEx转换器未绑定颜色规则，是导致异常显示为灰色的直接原因。可在项目resources目录下新建logback-spring.xml配置文件，自定义控制台输出的颜色映射规则：

<configuration>
  <!-- 引入Spring Boot默认日志基础配置 -->
  <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
  <!-- 注册Spring Boot自带的日志颜色转换规则 -->
  <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
  <conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />

  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <!-- 启用Jansi ANSI支持，兼容多终端环境 -->
    <withJansi>true</withJansi>
    <encoder>
      <charset>UTF-8</charset>
      <!-- 自定义日志格式：为ERROR级日志及关联堆栈绑定红色标识 -->
      <pattern>
        %clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint}
        %clr(%5p)
        %clr(${PID:- }){magenta}
        %clr(---){faint}
        %clr([%15.15thread]){faint}
        %clr(%-40.40logger{39}){cyan}
        %clr(:){faint}
        %m%n
        <!-- 为异常堆栈绑定级别关联的颜色，ERROR级别强制红色 -->
        %clr(%wEx){ERROR:-red, WARN:-yellow, INFO:-green, DEBUG:-cyan}
      </pattern>
    </encoder>
  </appender>

  <root level="info">
    <appender-ref ref="CONSOLE" />
  </root>
</configuration>

常见配置踩坑说明 #

• 不要使用logback.xml作为配置文件名，Spring Boot 仅会优先加载logback-spring.xml来识别适配Spring环境的日志规则，文件名错误会导致自定义配置完全不生效
• Windows 低版本原生CMD环境下，需添加JVM启动参数 -Dlogback.ansi.enable=true 强制启用ANSI颜色支持，否则配置的颜色规则不会生效
• 若引入的第三方依赖内置了日志配置，需确保项目下的logback-spring.xml配置优先级高于依赖内置配置，避免规则被覆盖

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