logback-spring.xml 必须放在 src/main/resources/ 目录下，不可在子目录中；使用 -spring.xml 后缀才能启用 Spring Boot 的 <springProfile>、<springProperty> 等扩展功能。
Logback 的 logback-spring.xml 放哪才生效
Spring Boot 只认特定路径和命名的配置文件，放错位置等于没配。默认情况下，logback-spring.xml 必须放在 src/main/resources/ 下，且不能放在子目录里（比如 src/main/resources/config/ 就不识别）。
为什么用 -spring.xml 后缀？因为 Spring Boot 提供了扩展能力（比如 <springProfile>、<springProperty>），普通 logback.xml 不支持这些标签。
- 如果用了
logback.xml，Spring Boot 会跳过自己的日志初始化逻辑，@ConfigurationProperties绑定的日志配置、profile 切换都会失效 - IDEA 中若提示 “No logback configuration file detected”，先检查文件名是否拼错（比如写成
logback-spring.xml.bak或大小写错误） - 打包后运行
java -jar app.jar，配置仍生效；但若用java -Dlogging.config=xxx.xml -jar手动指定，就绕过了 Spring Boot 的增强逻辑，<springProfile>等标签直接报错
<springProfile> 怎么切环境还不报错
这个标签不是 Logback 原生的，是 Spring Boot 注入的解析器，必须配合 logback-spring.xml 使用，否则启动时抛 ch.qos.logback.core.joran.spi.JoranException。
常见错误是 profile 名写错或没激活：比如写了 <springProfile name="prod">，但启动时没加 --spring.profiles.active=prod，也没在 application.yml 里设，默认 profile 是 default，结果该段配置完全不加载——你以为没生效，其实是“被跳过”了。
- 多 profile 可用逗号分隔：
<springProfile name="dev,staging"> - 取反写法：
<springProfile name="!test">表示“非 test 环境” - 不要在
<springProfile>外面嵌套<appender>，它只能包裹<appender>、<logger>、<root>等顶层节点
控制台输出乱码、文件中文日志变问号
根本原因是 Logback 默认编码是 UTF-8，但 Windows 控制台（cmd/powershell）默认是 GBK，而部分旧版 JDK 在获取系统编码时会出错，导致控制台输出中文变成 ???。
解决重点不在 Logback 配置本身，而在 JVM 启动参数和 appender 的 encoder 设置是否一致：
- 确保
<encoder>显式指定：<charset>UTF-8</charset>（别依赖默认） - Windows 下启动应用时加上：
-Dfile.encoding=UTF-8，否则System.getProperty("file.encoding")可能返回GBK，影响某些 encoder 实现 - IntelliJ IDEA 运行配置里也要勾选 “Override encoding from properties files” 并设为 UTF-8，否则编辑器编码设置会干扰运行时
- 文件 appender 的
<fileNamePattern>路径含中文没问题，但注意 Linux 文件系统挂载时是否启用 utf8 选项（少见，但生产环境 NFS 共享盘偶发）
AsyncAppender 加了反而变慢甚至丢日志
异步日志不是开箱即用的银弹。Logback 的 AsyncAppender 是装饰器模式，它把日志事件塞进阻塞队列，由后台线程消费。一旦队列满、消费者卡住或未配置合理参数，就会拖慢主线程甚至丢日志。
典型症状：高并发下接口 RT 上升，WARN 日志突然消失，日志文件增长变慢。
- 必须设置
<queueSize>256</queueSize>（默认 256，但很多教程不提，小流量测试不出问题） - 务必加
<discardingThreshold>0</discardingThreshold>，否则队列满时默认丢弃 WARN/ERROR 以外的日志（静默丢弃！） - 慎用
<includeCallerData>true</includeCallerData>，它触发堆栈遍历，严重拖慢异步线程，且多数场景不需要精确到行号 - 异步 appender 不能嵌套异步（比如 AsyncAppender 包 AsyncAppender），会导致锁竞争加剧
