主题
测试策略
1. 分层
| 层级 | 范围 | 工具 | 位置 |
|---|---|---|---|
| 单元测试 | Service 逻辑、转换器、工具类 | JUnit5 + Mockito | src/test/java,与实现同包 |
| 集成测试 | Mapper + H2、Controller 链路 | BaseDbUnitTest / BaseMockitoUnitTest | 各模块 src/test |
| 端到端 | 门户 → 登录 → 列表 / CRUD | tools/demo/smoke.mjs(只读)+ tools/demo/smoke-write.mjs(写链路) | tools/demo/ |
| 契约 | 写表单 ↔ 后端 SaveReqVO 字段约束 | tools/arch/check-write-config.mjs(CI contract job) | tools/arch/ |
2. 现状(2026-11-19)
- 全量
mvn test:2 102 用例通过、0 失败、258 跳过(外部依赖相关)。 - 数据库层测试覆盖:system、infra、bpm、im、member、pay、wms、mes、mall(trade)、iot、crm、erp、mp、report 均有 H2 用例;本轮新增 5 个模块的 Mapper 建表与用例(crm 5、erp 5、mp 4、iot 4、trade 4)。
- 已无「零测试模块」;mall 其它子模块(product/promotion/statistics)与 report 仍以 Service 层用例为主,DDL 转 Flyway 后需同步补齐。
2.1 复现单模块测试
bash
# 只跑本次新增的 Mapper 用例(-am 会带上依赖模块)
mvn -B -ntp -pl modules/crm,modules/erp,modules/mp -am test \
-Dtest='CrmCustomerMapperTest,ErpProductMapperTest,MpAccountMapperTest' \
-Dsurefire.failIfNoSpecifiedTests=false2.2 演示链路冒烟
演示站的两条冒烟脚本都是 Node 18+ 零依赖(内置 fetch),既能本地跑也能在 CI 的 demo-smoke job 里跑:
bash
# 只读:登录 + 门户首页 + 38 个列表接口(--strict 时空列表也算失败)
node tools/demo/smoke.mjs --base http://127.0.0.1:48080 --strict
# 写链路:10 个用例,每个走「创建 → 按 id 查询 → 更新 → 列表可见 → 删除 → 确认已删除」
node tools/demo/smoke-write.mjs --base http://127.0.0.1:48080smoke-write.mjs 的用例与 bizModules.ts 的 write 配置一一对应;新增可写页面时同步补一条用例, 否则页面写了但链路没人验证。脚本用时间戳做名称后缀避免重名,跑完会删掉临时数据(逻辑删除行由 reset-demo.mjs 的主键区间清理兜底)。
3. 约定
- 新增 Service 方法必须配单测(正常路径 + 至少一个异常路径)。
- 需要数据库的测试用 H2(
modules/<module>/src/test/resources/sql/create_tables.sql),不连真实 MySQL。 - 新增模块的 H2 建表脚本按 DO 字段生成(
@TableName+private字段 +BaseDO/TenantBaseDO审计列),生成后补clean.sql(DELETE FROM全表,测试方法后清理)与application-unit-test.yaml/logback.xml。 - 每个 Mapper 至少覆盖:插入后全字段回读(防 DO 加字段忘改建表脚本)、条件查询/分页、状态机式更新(仅当状态匹配才更新)。
- 修 Bug 先补回归测试,再改实现。
- 禁止
Thread.sleep等待异步结果,用 Awaitility 或直接测试同步分支。