Logback 的 TimeBasedRollingPolicy 不支持 yyyy-ww 格式进行周级归档，必须使用 yyyy-MM-dd 或基于周期的 %-d{...} 配合 TimeBasedFileNamingAndTriggeringPolicy 才能实现真正按周（周一至周日）滚动；常见错误是路径不一致或误用占位符。
logback 的 `timebasedrollingpolicy` 不支持 `yyyy-ww` 格式进行周级归档，必须使用 `yyyy-mm-dd` 或基于周期的 `%-d{...}` 配合 `timebasedfilenamingandtriggeringpolicy` 才能实现真正按周（周一至周日）滚动；常见错误是路径不一致或误用占位符。
在 Logback 中实现按自然周（如每周一 00:00 开始）滚动日志，不能简单依赖 <fileNamePattern>log-%d{yyyy-ww}.log.gz</fileNamePattern> —— 因为 ww（一年中的第几周）仅用于格式化输出，不参与滚动触发逻辑。TimeBasedRollingPolicy 实际依据的是 fileNamePattern 中的最小时间单位（如 yyyy-MM-dd 触发每日滚动，yyyy-MM 触发每月滚动），而 ww 并非有效的时间对齐单位，Logback 无法据此确定滚动边界。
✅ 正确做法：使用 yyyy-MM-dd 模式 + SizeAndTimeBasedFNATP（推荐）或自定义 TimeBasedFileNamingAndTriggeringPolicy 实现周级归档。但更简洁、生产可用的方式是：
✅ 推荐方案：按周滚动（周一为起点）—— 使用 %-d{yyyy-MM-dd} + maxHistory 控制保留周数
<appender name="ROLLING_WEEKLY" class="ch.qos.logback.core.rolling.RollingFileAppender">
<!-- 主日志文件路径（当前写入） -->
<file>${LOG_PATH}/${LOG_NAME}.log</file>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!-- 关键：使用 yyyy-MM-dd，Logback 自动按天归档；再通过触发策略+清理逻辑模拟“周滚动” -->
<!-- 更优实践：直接按周归档 → 改用以下 fileNamePattern（Logback 1.4+ 原生支持周滚动） -->
<!-- 注：1.4.0+ 可用 %d{yyyy-'W'w}，但需配合 TimeBasedFileNamingAndTriggeringPolicy -->
<!-- ✅ Logback 1.4+ 推荐写法（真正按 ISO 周滚动） -->
<fileNamePattern>${LOG_PATH}/${LOG_NAME}.%d{yyyy-'W'w}.%d{yyyy-MM-dd}.log.gz</fileNamePattern>
<!-- 若使用旧版（<1.4），请改用 daily 滚动 + 脚本/外部清理，或升级 -->
<timeBasedFileNamingAndTriggeringPolicy
class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
<maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
<maxHistory>26</maxHistory> <!-- 保留最近 26 周（即约半年） -->
</rollingPolicy>
</appender>⚠️ 关键注意事项：
- fileNamePattern 中的路径（如 ${LOG_PATH}/${LOG_NAME}）必须与 <file> 标签的路径前缀严格一致，否则归档失败（原问题即因移动日志目录后未同步更新 fileNamePattern 导致）；
- 强烈建议统一使用 <property> 定义路径变量（如 <property name="LOG_PATH" value="/var/log/myapp"/>），并在 <file> 和 <fileNamePattern> 中复用（如 ${LOG_PATH}/app.log 和 ${LOG_PATH}/app.%d{yyyy-MM-dd}.log.gz），避免硬编码不一致；
- yyyy-ww 仅作显示用，不可用于触发滚动；Logback 官方文档明确说明：滚动周期由 fileNamePattern 中最细粒度的有效日期字段决定（支持 yyyy、yyyy-MM、yyyy-MM-dd、yyyy-MM-dd_HH 等）；
- 若需严格按“周一 00:00”切分周，且使用 Logback < 1.4，请结合 SiftingAppender 或外部定时任务压缩/归档，或升级 Logback。
? 调试技巧：启用 Logback 内部状态输出，在 logback.xml 顶部添加：
<configuration debug="true">
可查看滚动策略是否被正确识别、归档时间点是否匹配预期。
总之，周级滚动不是靠 ww 占位符实现的，而是依赖 Logback 对时间单位的解析能力与配置一致性。统一变量、选用合适版本、验证路径一致性，是解决该类问题的核心。
