Logback 的 TimeBasedRollingPolicy 不支持 yyyy-ww 格式进行周级归档，必须使用 yyyy-MM-dd 或基于周期的 %-d{...} 配合 TimeBasedFileNamingAndTriggeringPolicy 才能实现真正按周（周一至周日）滚动；常见错误是路径不一致或误用占位符。

logback 的 `timebasedrollingpolicy` 不支持 `yyyy-ww` 格式进行周级归档，必须使用 `yyyy-mm-dd` 或基于周期的 `%-d{...}` 配合 `timebasedfilenamingandtriggeringpolicy` 才能实现真正按周（周一至周日）滚动；常见错误是路径不一致或误用占位符。

在 Logback 中实现按自然周（如每周一 00:00 开始）滚动日志，不能简单依赖 log-%d{yyyy-ww}.log.gz —— 因为 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>

⚠️ 关键注意事项：

笔魂AI

一款面向在线AI绘画和视觉设计的创作工具，帮助用户利用生成式AI制作插画、图片及多种创意视觉素材。

下载

• fileNamePattern 中的路径（如 ${LOG_PATH}/${LOG_NAME}）必须与 标签的路径前缀严格一致，否则归档失败（原问题即因移动日志目录后未同步更新 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

? 调试技巧：启用 Logback 内部状态输出，在 logback.xml 顶部添加：

<configuration debug="true"></configuration>

可查看滚动策略是否被正确识别、归档时间点是否匹配预期。

总之，周级滚动不是靠 ww 占位符实现的，而是依赖 Logback 对时间单位的解析能力与配置一致性。统一变量、选用合适版本、验证路径一致性，是解决该类问题的核心。