# 测试完善与回归执行报告

日期：2026-10-11。用户要求完善单元测试与完整测试文档。本轮补齐测试、修复测试发现的对象所有权问题，并核对关键故障用例是否真的被 Linux 收集。源码目录没有 Git 仓库，不编造提交号；[源码 SHA256 清单](evidence-test-hardening/source-SHA256SUMS)记录真实字节状态，执行证据在 [evidence-test-hardening](evidence-test-hardening/inventory.json)。当前 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/截图，无远程执行宣称。
- 交付[测试手册](../04-testing/testing-guide.md)、[用例目录](../04-testing/test-cases.md)，更新[测试设计](../04-testing/test-design.md)、目标、规范、开发记录、README 与代码阅读指南。

新增测试注释解释触发条件、预期、不变量和数据/资源所有权；SQLite 与真实认证不以 mock 代替持久性，纯核心/前端单元也不启动用户服务。

## 2. 发现与修复

### 2.1 首次响应污染幂等记忆

`Engine.Apply` 已把 Order 从核心订单分离，但保存到 dedupe 的首次 Result 仍共用返回的 Order 指针。修改调用者拿到的 `first.Order.Status` 会让原键重试得到污染后的状态。[修复前失败输出](evidence-test-hardening/ownership-before.txt)证实这一点。

现在核心去重表另存一份 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](evidence-test-hardening/crash-windows.txt)（文件名只描述故障窗口结果，不是 Go 源码），最终 JSON 有六个 pass；[collection.json](evidence-test-hardening/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](evidence-test-hardening/inventory.json)。

```bash
# 主验收：完整检查、覆盖率、有限 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](evidence-test-hardening/all-final.txt) |
| Go 正常/覆盖率执行 | 72 个顶层 Test/Fuzz 通过，140 个子用例通过；1 个故障子进程 helper 预期 skip；4 个含测试包通过 | [go-tests.jsonl](evidence-test-hardening/go-tests.jsonl) / [最终覆盖率执行](evidence-test-hardening/coverage-run-final.txt) |
| 完整 Go race | 通过，无 race；含新收集的六个精确窗口 | [race-final.txt](evidence-test-hardening/race-final.txt) |
| 独立单元入口 / 关键回归重复 race | unit 通过；所有权/认证回滚/六窗口 `-count=3` 通过 | [unit.txt](evidence-test-hardening/unit.txt) / [repeat-race.txt](evidence-test-hardening/repeat-race.txt) |
| 前端单元 | 34 passed，无失败/跳过 | all-final / [unit.txt](evidence-test-hardening/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 对应这两项收尾。前端与生产代码此后无修改，不重复浏览器或压力实验。[向量](evidence-test-hardening/token-vector.txt)、[金额规范化](evidence-test-hardening/decimal-normalization.txt)与最终输出均可复核。

## 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](evidence-test-hardening/coverage.txt)，可交互源码视图见 [coverage.html](evidence-test-hardening/coverage.html)，标准 profile 见 [coverage.out](evidence-test-hardening/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等未实现，不纳入当前通过宣称。完整待执行区见[用例目录](../04-testing/test-cases.md)。

## 后续文档修订说明

后续[文档与注释报告](2026-10-11-documentation.md)只完善解释并核对行为不变。本文原始日志/覆盖率/source-SHA256SUMS 保持当时内容；源码注释更新后字节摘要会不同，不倒填新摘要或把历史性能/发布包升级成当前成绩。
