forge_admin/code-copilot/changes/定时任务并发重试治理/execution-log.md

定时任务并发重试治理执行记录

status: completed

2026-07-20 基线

• 用户确认继续执行路线图下一步，V4 按 定时任务并发重试治理 进入 apply。
• 依赖 V1、V3 已完成；V2 功能完成但真实浏览器 UI 验收仍由用户执行。
• V3 基线：Job 模块 63/63、前端定向单测 10/10、Admin Reactor 42/42 和前端生产构建通过。
• 当前最大 Flyway 版本为 V1.0.42，V4 迁移使用 V1.0.43。
• 确认语义：SKIP_IF_RUNNING 立即跳过不排队；只有显式幂等任务允许有限重试；Misfire 只支持 FIRE_ONCE_NOW、DO_NOTHING。
• 本轮默认不启动真实 MySQL、Redis、Admin 或 Quartz 集群，不把可重复单元测试表述为真实多实例 E2E。
• 工作区已有 V1-V3 未提交改动并与 V4 共用 Job 核心文件；为避免把既有改动误归入独立提交，本轮不自动提交或推送。

2026-07-20 Task 1 策略字段和枚举

• 新增并发策略 ALLOW/SKIP_IF_RUNNING、Misfire 策略 FIRE_ONCE_NOW/DO_NOTHING 和日志执行状态常量。
• 配置 DTO、Entity、Model、VO 增加策略与幂等字段；日志 Entity、Model 增加计划触发时间和 Quartz 执行实例 ID。
• 新增 V1.0.43__add_job_execution_policies.sql，使用 information_schema 和 WHERE NOT EXISTS 保护字段、存量默认值和字典数据。
• 校验规则：空策略归一为 ALLOW/DO_NOTHING，重试次数限制为 0-5，非幂等任务禁止自动重试。
• 定向测试：JobExecutionPolicyMigrationContractTest,JobConfigValidatorTest，17/17 通过。
• 首次实现后测试编译发现测试变量不满足 effectively-final，拆分独立请求变量后重跑通过；主代码编译无错误。

2026-07-20 Task 2-5 执行治理

• 执行生命周期：接受触发时插入 RUNNING，终态 SQL 仅允许 status=2 的原记录转成功、失败或跳过；生命周期与 Mapper 契约测试 5/5 通过。
• 分布式并发：SKIP_IF_RUNNING 使用 forge:job:execution:<jobConfigId> 零等待 Redisson 锁；竞争、Redis 缺失和异常均不放行业务执行；锁与重试测试 7/7 通过。
• 有限重试：固定 1000ms 退避、最多 5 次，非幂等任务在执行层强制不重试；远程 RPC 路由内部重试已移除，避免嵌套放大。
• Quartz 集成：手动/计划触发复用同一治理链路，ONCE 在成功、失败和跳过后均执行完成态；执行入口与 Misfire 定向测试 14/14 通过。
• Misfire：CRON 映射 FireAndProceed/DoNothing，ONCE 映射 FireNow/NextWithRemainingCount。
• 前端：高级设置增加并发、Misfire、幂等与重试策略；日志和最近结果改用 sys_job_log_status；表单与 Cron 定向测试 13/13 通过。

2026-07-20 最终验收

• 收尾修正：失败执行记录保存经脱敏和 4000 字符限长的异常堆栈；Redisson Provider 获取异常也按失败关闭处理；清理 application-job-example.yml 末尾失效注释。
• 可重复竞争测试：两个 JobExecutionLockManager 共享同一测试锁状态，首个管理器持锁时第二个立即返回竞争，释放后可以重新获取；该测试不等同于真实 Redis 多实例 E2E。
• 定向后端：Java 17 下执行 mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-job -am -Dtest=JobExecutionLifecycleServiceTest,JobExecutionLockManagerTest -Dsurefire.failIfNoSpecifiedTests=false test，5/5 通过，Reactor 14/14 成功。
• Job 全量：Java 17 下执行 mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-job -am test，84/84 通过，Reactor 14/14 成功。
• 前端单测：Node 20.19.0 下执行 pnpm exec vitest run src/views/system/job-config/__tests__/job-config-form.test.js src/components/job/__tests__/cron-builder.test.js，13/13 通过。
• 前端 Lint：Node 20.19.0 下对 Job API、工作台、计划组件、日志页面和两组测试执行定向 pnpm exec eslint，通过且无输出。
• 前端构建：Node 20.19.0 下执行 NODE_OPTIONS=--max-old-space-size=8192 pnpm build，通过；保留仓库既有组件命名、动态/静态导入和 CSS 注释警告。
• Admin 聚合：Java 17 下执行 mvn -pl forge-admin-server -am package -DskipTests，Reactor 42/42 成功；保留既有 deprecation 和 unchecked 警告。
• 静态检查：两个 Job Mapper XML 通过 xmllint --noout；V1.0.43 无 Flyway ${...} 占位符；Job Service 无 LambdaQueryWrapper/lambdaQuery；冲突标记扫描和 git diff --check 通过。
• 过程说明：首次收尾命令因显式 PATH 未包含 Maven 而未启动；首次堆栈断言因 Mockito 混用匹配器失败，统一参数匹配器后定向和全量测试均通过。
• 跳过项：未启动真实 MySQL、Redis 集群、Admin 后端或浏览器自动化；真实 Flyway 执行和 Redis 多实例竞争需在部署环境验收。
• 启停服务：无。
• 提交：未创建。V1-V3 未提交改动与 V4 共用 Job 核心文件，当前不适合生成边界不清的独立提交。