# 定时任务并发重试治理测试计划
> status: completed
> updated: 2026-07-20

## 1. 验证目标

复用 V3 Job 模块 63/63、前端定向单测 10/10、Admin Reactor 42 模块和生产构建基线，增量验证 V4 的执行状态机、任务级分布式 tryLock、显式幂等重试和 Quartz Misfire 策略。

## 2. 验证矩阵

| 优先级 | 范围 | 验证方式 |
|---|---|---|
| P0 | 策略字段、日志执行字段、字典和存量回填 | JobExecutionPolicyMigrationContractTest |
| P0 | 非幂等重试拒绝、策略值和次数上限 | JobConfigValidatorTest |
| P0 | RUNNING 到 SUCCESS/FAILED/SKIPPED 单记录流转 | JobExecutionLifecycleServiceTest、Mapper XML 契约 |
| P0 | ALLOW、锁竞争立即跳过、Redis 缺失/异常失败关闭 | JobExecutionLockManagerTest |
| P0 | 固定退避、有限重试和实际重试次数 | JobRetryExecutorTest |
| P0 | 手动/计划触发统一策略、一次执行只产生一条日志 | QuartzJobExecutorTest |
| P0 | CRON/ONCE 的 FIRE_ONCE_NOW、DO_NOTHING | JobSchedulerTest |
| P1 | 配置工作台策略回显、提交和日志状态展示 | 前端定向 Vitest、ESLint、生产构建 |

## 3. 必跑命令

- Job 模块：`mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-job -am test`
- 前端单测：`pnpm exec vitest run src/views/system/job-config/__tests__/job-config-form.test.js src/components/job/__tests__/cron-builder.test.js`
- 前端检查：V4 定向 ESLint、`pnpm build`
- 静态检查：Mapper XML、Flyway placeholder、Service 查询规范、冲突标记、`git diff --check`
- 聚合验证：`mvn -pl forge-admin-server -am package -DskipTests`

## 4. 边界

- 不启动真实 MySQL、Redis、Admin 或 Quartz 集群；Flyway 和多实例 Redis 联调由开发环境验收。
- 分布式竞争使用两个锁管理器共享同一测试锁状态复现，不把单 JVM 测试表述为真实集群 E2E。
- 本轮不增加告警、监控、开放 API、Webhook 或 Flowable 编排。

## 5. 验证结果

- 生命周期和锁管理器收尾测试：5/5 通过；覆盖脱敏堆栈、Provider 异常失败关闭和两个锁管理器竞争。
- Job 模块全量测试：84/84 通过，Maven Reactor 14/14 成功。
- 前端定向 Vitest：13/13 通过；V4 相关文件定向 ESLint 通过。
- 前端生产构建通过；Admin Maven Reactor 42/42 成功。
- Mapper XML、Flyway placeholder、Service 查询规范、冲突标记和 `git diff --check` 通过。
- 未执行真实 MySQL、Redis 集群、Admin 服务或浏览器自动化，按第 4 节边界留待环境验收。