Spring Boot 控制台日志格式自定义完全指南

本文详解如何通过 `logging.pattern.console` 属性精准定制 spring boot 应用的控制台日志输出顺序与内容，支持插入应用名、调整 pid/日志级别位置、添加自定义标识等，无需引入额外依赖。

在 Spring Boot 中，控制台日志默认采用 Logback（底层为 SLF4J）输出，其格式由 logging.pattern.console 属性统一控制。若希望将原始日志格式：

2025-01-30T21:21:06.076+08:00  INFO 5216 --- [           main] org.example.Main : ...

重构为更符合运维习惯的结构——时间戳 → PID → 日志级别 → 分隔符 → 应用名 → 线程 → 类名 → 消息，例如：

2025-01-30 21:21:06 INFO  5216 --- [myapp] [main] org.example.Main : Started Main in 3.544 seconds...

只需在 application.properties（或 application.yml）中配置自定义 pattern 即可。

✅ 推荐配置（application.properties）：

# 自定义控制台日志格式（ISO 8601 时间 + PID + 级别 + 应用名 + 线程 + 类名）
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss.SSS} ${PID:-} %-5level --- [${spring.application.name:-unknown}] [%thread] %logger{36} : %msg%n

? 关键占位符说明：

• %d{...}：日期时间格式，推荐使用 HH:mm:ss.SSS 提升可读性（也可保留 T 格式如 %d{yyyy-MM-dd'T'HH:mm:ss.SSSXXX}）；
• ${PID:-}：Spring Boot 内置变量，自动注入当前进程 ID，:- 表示空值默认为空字符串；
• %-5level：左对齐、最小宽度 5 的日志级别（INFO/DEBUG 等），保证对齐美观；
• ${spring.application.name:-unknown}：读取 spring.application.name 配置，未配置时显示 unknown；
• [%thread]：包裹线程名（如 [main] 或 [http-nio-8080-exec-1]）；
• %logger{36}：截取类名至最多 36 字符，避免过长影响阅读；
• %msg%n：原始日志消息 + 换行符。

⚠️ 注意事项：

• ❌ 不要使用 logging.pattern.level 单独配置级别格式——它仅影响级别字段本身（如添加 traceId），无法改变整体布局顺序；
• ✅ 所有 ${...} 占位符必须在 logging.pattern.console 字符串内直接使用，Spring Boot 会自动解析；
• ? 若使用 application.yml，需注意 YAML 的缩进与引号规则（建议用单引号包裹 pattern 字符串以防特殊字符解析错误）：

  logging:
    pattern:
      console: '%d{yyyy-MM-dd HH:mm:ss.SSS} ${PID:-} %-5level --- [${spring.application.name:-unknown}] [%thread] %logger{36} : %msg%n'

? 进阶提示：

• 可嵌入 MDC（Mapped Diagnostic Context）字段增强上下文，例如 %X{traceId:-} 追加链路追踪 ID；
• 若需区分环境（如 dev/test/prod），可通过 @Profile 配置多环境 pattern，或结合 spring.profiles.active 动态加载不同 application-{profile}.properties；
• 生产环境建议同时配置 logging.pattern.file 保持文件日志格

  

  式一致，便于 ELK 等工具解析。

通过以上配置，即可零侵入、高灵活性地实现日志格式的标准化定制，大幅提升日志可读性与运维效率。