日期:2026-10-11。用户要求完善单元测试与完整测试文档。本轮补齐测试、修复测试发现的对象所有权问题,并核对关键故障用例是否真的被 Linux 收集。源码目录没有 Git 仓库,不编造提交号;源码 SHA256 清单记录真实字节状态,执行证据在 evidence-test-hardening。当前 API/engine/schema 版本不变。
1. 交付内容#
- 新增 36 个 Go
Test函数和一个游标 fuzz 目标,覆盖金额输入、两方向价格/FIFO、拒绝无资金副作用、首次幂等结论、调用者/核心/投影所有权、会话过期/停用回滚、全管理路由 RBAC、HTTP 输入/资源/静态文件、游标、诊断、启动配置及离线 CLI 全链。 - 核心测试的每步不变量增加价树/FIFO/反向索引逐节点检查、同价序号递增、数量非负和方向匹配。
- 前端新增 34 个 Node 单元用例,执行真实 TS 源码;覆盖 fetch 的原内容/原键、坏响应/超时、未知执行分类、数据集和待确认存储校验。恢复解析显式注入只读存储,hook/页面交互继续由真实 Playwright 验证。
- 新增
scripts/test.sh的 unit/backend/coverage/fuzz/browser/all 入口;verify 集成前端单元及精确故障用例收集检查;CI 保留覆盖率/JSON/截图,无远程执行宣称。 - 交付测试手册、用例目录,更新测试设计、目标、规范、开发记录、README 与代码阅读指南。
新增测试注释解释触发条件、预期、不变量和数据/资源所有权;SQLite 与真实认证不以 mock 代替持久性,纯核心/前端单元也不启动用户服务。
2. 发现与修复#
2.1 首次响应污染幂等记忆#
Engine.Apply 已把 Order 从核心订单分离,但保存到 dedupe 的首次 Result 仍共用返回的 Order 指针。修改调用者拿到的 first.Order.Status 会让原键重试得到污染后的状态。修复前失败输出证实这一点。
现在核心去重表另存一份 Order,返回首次/重试都与记忆和可变核心对象独立。TestCoreResultOwnership 修改返回指针和投影副本后检查核心、首次结论及副作用为空;不只断言没有 race。
2.2 响应与尚未提交投影共用数据#
projector 先回传 Result 后落库,原本只按值复制结构,切片底层数组与指针仍共享。Go 调用者能够修改尚未落库的订单/余额/分录。现在外围 copyResult 将所有指针和切片分离,再送给调用者;核心不做网络/序列化,日志屏障和回包顺序不变。
TestRuntimeResponseCannotMutateProjection 占用唯一 Views 连接保证投影暂停;拿到回包后修改结果,释放连接并排空,SQL 仍保持 OPEN、available=900、frozen=100、原键首次状态 OPEN。该回归与 TestCopyResultIncludesEveryMutableField 覆盖 Order/Error/Orders/Balances/Trades/Entries。复制增加少量外围分配,历史性能报告不是这次修复后的新容量成绩。
2.3 Linux 静默遗漏六个精确故障窗口#
旧文件名 crash_windows_test.go 的 _windows_test.go 后缀被 Go 识别为 GOOS=windows。此前 Linux/WSL 的 go test ./... 与 race 没有收集 TestCrashRecoveryWindows。这是上一版报告的遗漏:已有 crash_check.py 的真实服务 SIGKILL/restart 通过,但不能据此宣称六个精确 hook 窗口通过。
本轮改名为 crash_recovery_test.go,增强子进程日志/退出状态与 SQL 错误断言,实际运行并通过提交前、提交后、Apply 后、投影前、投影事务内、恢复中六个窗口。verify 显式检查 go test -list 包含父用例,防止未来文件名/构建约束再次无声漏测。现有报告在对应位置加了更正,不能倒写成上一轮当时已经执行。
单独窗口输出见 crash-windows.txt(文件名只描述故障窗口结果,不是 Go 源码),最终 JSON 有六个 pass;collection.json确认当前 Linux 收集到改名后的测试文件。TestCrashWindowChild 普通运行时 skip 是预期,父进程专门启动它才注入故障,不暴露生产 API。
3. 环境与执行#
环境:Linux WSL2 6.6.87.2 amd64、Go 1.26.9、Node 22.22.3、Python 3.10.12。源码位于 /mnt/d/codex小项目/go/web3,Go/CLI/浏览器使用各自独立临时数据;未接触用户 data/、未部署云、未执行容器/容量新实验。环境与用例统计见inventory.json。
# 主验收:完整检查、覆盖率、有限 fuzz、真实浏览器,失败立即停止。 EXCHANGE_TEST_OUTPUT_DIR=docs/reports/evidence-test-hardening bash scripts/test.sh all # 明确验证独立单元入口,以及所有权/回滚/精确崩溃的重复 race。 bash scripts/test.sh unit go test -race -count=3 -timeout 120s -run 'TestCoreResultOwnership|TestRuntimeResponseCannotMutateProjection|TestDisableAuditFailureRollsBack|TestCrashRecoveryWindows' ./backend |
| 检查 | 最终实际结果 | 证据 |
|---|---|---|
| 格式、mod verify、关键用例收集、vet | 通过 | all-final.txt |
| Go 正常/覆盖率执行 | 72 个顶层 Test/Fuzz 通过,140 个子用例通过;1 个故障子进程 helper 预期 skip;4 个含测试包通过 | go-tests.jsonl / 最终覆盖率执行 |
| 完整 Go race | 通过,无 race;含新收集的六个精确窗口 | race-final.txt |
| 独立单元入口 / 关键回归重复 race | unit 通过;所有权/认证回滚/六窗口 -count=3 通过 |
unit.txt / repeat-race.txt |
| 前端单元 | 34 passed,无失败/跳过 | all-final / unit.txt |
| OpenAPI/TS 生成、前端格式与 tsc/Vite build | 全部通过 | all-final 输出 |
| 真实服务 SIGKILL/restart | 身份/会话/订单/余额/幂等通过 | all-final 的 PASS 行 |
| 精确窗口 | 六个父子进程场景通过,恢复及原键确认不重复 | JSON / crash-windows 输出 |
| 金额 fuzz | 2 workers,设定3s,31308 次执行通过 | all-final 输出 |
| 游标 fuzz | 2 workers,设定3s,4995 次执行通过,结束总耗时约4s | all-final 输出 |
| 浏览器 | 8 passed,19.8s 是 runner 时间,不是性能成绩 | all-final 输出 |
统计按 Go JSON 区分顶层/子用例,包含两个 fuzz 的种子入口,不把子用例再次相加成独立业务规则数量。api 包没有独立 Test,但嵌入契约由后端真实响应测试使用;无独立测试文件不代表业务未验证。fuzz 的探索缓存、机器状态会影响执行数,不设置固定次数作为所有机器门槛。
all-final 全套后,将 token 摘要断言改为独立 SHA256 已知向量,并在已有 HTTP 测试中补充 1.00/1 与 1.0000/1 原键确认无重复冻结的子用例。分别定向验证通过,再重跑全部 Go 覆盖率、race 和 vet;最终 JSON/coverage/race-final 对应这两项收尾。前端与生产代码此后无修改,不重复浏览器或压力实验。向量、金额规范化与最终输出均可复核。
4. 覆盖率#
使用 go test -count=1 -coverprofile=... -json ./... 与 go tool cover -func;总值是各语句加权,不是包百分比平均。
| 包/范围 | 之前基线 | 本轮最终语句覆盖率 |
|---|---|---|
| backend | 78.5% | 82.3% |
| cmd/exchangectl | 0% | 73.7% |
| cmd/loadcheck | 0% | 17.8% |
| cmd/server | 0% | 33.7% |
| Go profile 合计 | 67.5% | 75.5% |
函数明细见 coverage.txt,可交互源码视图见 coverage.html,标准 profile 见 coverage.out。Apply=98.6%、place=95.9%;金额解析和两种游标解码为100%语句覆盖。剩余分支包括不可恢复序号不变量 panic、活动订单上限、随机源/文件/数据库部分失败,以及入口 main、长时负载 execute、真实进程环境等。没有声称100%条件覆盖或全部故障穷尽。
基线取本轮改动前实际执行;新增测试发现故障文件未被 Linux 收集,说明百分比不能证明关键恢复性质被测到。前端当前是用例通过清单,无行/分支覆盖率产物;TS 模块擦除类型后被执行,类型检查另由 tsc 保证。被杀子进程、真实服务和浏览器不会自动合入父进程 Go coverage。
5. 收尾与边界#
本轮当前源码的单元/组件/集成/精确故障/真实浏览器回归已完成,日志与查询语义不变;为响应/投影/幂等记忆落实独立对象所有权。最终构建产物 bin/exchange / bin/exchangectl / frontend/dist 已随 verify 更新;此前 bin/releases/exchange-v0.3.0.tar.gz 和 v0.3 验证镜像属于上一轮历史版本,未重新打包/容器实测,不把它们当作包含本轮修复的产物。
历史 v0.3 性能/容器/漏洞审计保持原始证据,本轮未重复漏洞扫描或压力实验,不把历史4000档成绩套作修复后新成绩。云实机、真实断电/满盘/fsync硬件失败、长时生产混合负载、冷缓存恢复、跨浏览器/完整无障碍与弱网矩阵仍未执行;Redis/多市场/分区/HA等未实现,不纳入当前通过宣称。完整待执行区见用例目录。
后续文档修订说明#
后续文档与注释报告只完善解释并核对行为不变。本文原始日志/覆盖率/source-SHA256SUMS 保持当时内容;源码注释更新后字节摘要会不同,不倒填新摘要或把历史性能/发布包升级成当前成绩。