Web3 交易系统
报告与验证记录

测试完善与回归执行报告

日期: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 保持当时内容;源码注释更新后字节摘要会不同,不倒填新摘要或把历史性能/发布包升级成当前成绩。

— 本篇阅读完毕 —
来源:Web3 交易系统 / docs / reports/2026-10-11-test-hardening.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭