[AI生成]
在 Spring Boot 中，日志相关配置统一写在 application.yml（或 application.properties）里，前缀都是 logging.。下面把常用的配置项按用途分类整理，并附上一份可直接参考的完整示例。

说明：你提到的应该是 application.yml（YAML 语法，logging: 后用缩进），而不是 application.xml。XML 格式一般用于 Logback/Log4j2 自身的配置文件（如 logback-spring.xml），两者作用不同。

一、logging.* 主要配置项

1. 日志级别（logging.level.*）

可以为根日志器或任意包/类设置级别，可选值：TRACE、DEBUG、INFO、WARN、ERROR、FATAL、OFF。

logging:
  level:
    root: info
    org.springframework.web: debug
    org.hibernate: error
    com.example.myapp: debug

2. 日志文件输出（logging.file.*）

默认只输出到控制台，需要写文件时必须配置其中之一；两者同时设置时以 name 为准，path 会被忽略。

3. 输出格式（logging.pattern.*）

自定义控制台与文件中的日志格式，支持 Logback 的 pattern 占位符。

4. 字符集与阈值（logging.charset.* / logging.threshold.*）

5. 日志分组（logging.group.*）

把多个 logger 打包成一组，便于统一调级。Spring Boot 内置了 web 和 sql 两个组。

logging:
  group:
    tomcat: org.apache.catalina, org.apache.coyote, org.apache.tomcat
  level:
    tomcat: trace

6. Logback 滚动策略（logging.logback.rollingpolicy.*）

仅在使用 Logback（默认）时生效，其他框架需在各自 XML 中配置。

7. 其他

二、完整示例

logging:
  # 1. 自定义日志配置文件（可选，优先级高于本文件中的大部分配置）
  config: classpath:logback-spring.xml
  # 2. 是否注册关闭钩子
  register-shutdown-hook: true
  # 3. 日志分组
  group:
    my-group: com.example.service, com.example.dao
  # 4. 日志级别
  level:
    root: info
    com.example: debug
    my-group: warn
    org.springframework.web: info
    org.hibernate.SQL: debug
  # 5. 文件输出
  file:
    name: logs/app.log          # 与 path 同时存在时，path 失效
    path: logs/
    max-size: 10MB
    max-history: 30
    total-size-cap: 1GB
    clean-history-on-start: false
  # 6. 输出格式
  pattern:
    console: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n"
    file: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n"
    dateformat: "yyyy-MM-dd HH:mm:ss.SSS"
    level: "%5p"
    rolling-file-name: "logs/app.%d{yyyy-MM-dd}.%i.gz"
  exception-conversion-word: "%wEx"
  # 7. 字符集与阈值
  charset:
    console: UTF-8
    file: UTF-8
  threshold:
    console: TRACE
    file: INFO
  # 8. Logback 滚动策略
  logback:
    rollingpolicy:
      file-name-pattern: "logs/app.%d{yyyy-MM-dd}.%i.gz"
      max-file-size: 10MB
      max-history: 30
      total-size-cap: 1GB
      clean-history-on-start: false

三、常见易错点

• file.name 与 file.path 同时写：只有 name 生效，path 会被忽略。
• 级别写成全大写：YAML 中需使用小写 trace/debug 等，Spring Boot 通过宽松绑定转换，但写成 TRACE 在某些版本下可能不生效，建议统一用小写。
• max-history/max-size 已被废弃：新版推荐使用 logging.logback.rollingpolicy.* 系列属性。
• 旧属性 logging.file：已被拆分为 name 和 path，不要再使用。
• 想完全自定义日志格式：可写 logback-spring.xml 并通过 logging.config 指向，能使用 Spring 扩展（如 <springProfile>、<springProperty>）；如果用 logback.xml 则无法享受这些扩展。
• Log4j2 用户：滚动策略需写在 log4j2-spring.xml 中，logging.logback.rollingpolicy.* 对它无效。