Skip to content

测试策略 ​

1. 分层 ​

层级范围工具位置
单元测试Service 逻辑、转换器、工具类JUnit5 + Mockitosrc/test/java,与实现同包
集成测试Mapper + H2、Controller 链路BaseDbUnitTest / BaseMockitoUnitTest各模块 src/test
端到端门户 → 登录 → 列表 / CRUDtools/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=false

2.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:48080

smoke-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 或直接测试同步分支。