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

首版开发验证记录

历史记录:下方结果与产物属于当时执行,不因后续源码注释/修复而自动更新。最新正确性与故障收集更正见测试完善报告,当前文档一致性见文档审阅报告。原始证据保留,不改写历史成绩。

日期:2026-10-10,注释与容器复核收尾:2026-10-11。环境:Linux/WSL amd64,Go 自动工具链 1.26.0,Node 22.22.3,Vite 6.4.4,Playwright 1.64.0,Docker 29.5.0;SQLite 驱动 modernc.org/sqlite v1.60.1,SELECT sqlite_version() 实际为 3.53.4。源码工作区在 /mnt/d,崩溃/浏览器数据目录使用 /tmp。

已实现范围#

普通用户注册/登录/退出,服务端会话/CSRF,管理员初始化、用户启用/停用、模拟资金增加与操作记录;单市场限价 GTC/IOC、市价保护 IOC、撤单、decimal 金额、红黑树/FIFO、资金冻结结算、单 goroutine 核心、外围日志批提交/投影/重放、实时共享行情快照。前端实际调用后端,没有 mock 成交。充分注释要求写入 goal.md/开发规范并补齐后端、前端、测试、脚本和部署说明,增加代码阅读指南。

实际执行#

检查 结果
go test ./… 通过;包含核心场景与存储/认证集成测试
go test -race ./… 通过,未报告数据竞争
go vet ./… 通过
npm –prefix frontend run build TypeScript + Vite 生产构建通过
npm –prefix frontend run format:check 通过,全部前端源码/测试/配置使用 Prettier 3.5.3 格式
npm audit 升级 Vite/Playwright 后 0 vulnerabilities
Playwright 真实后端联调 通过:两个注册用户、成交、撤余量、管理员登录/注资/停用用户、会话失效
移动端/动画 375px 无页面横向溢出;reduced-motion 可访问;无 pageerror;截图已检查
scripts/crash_check.py 通过:真实进程 SIGKILL/restart 后身份/会话/订单/余额/幂等保持;SIGTERM 正常退出
投影重建 集成测试通过:删除 views 后从 journal 重建余额/订单与去重状态
日志失败屏障 集成测试通过:日志不可写时核心不产生资金效果并进入失败状态
数据目录唯一写者 第二实例被拒绝
Docker runtime 镜像 最新本地静态产物构建、USER 10001、只读 rootfs + 持久卷启动和健康检查通过
容器真实联调 E2E_URL=18081 执行同一双用户/管理员浏览器场景,通过(1 test,13.3s 含启动)
容器持久性 同卷重建容器 + docker restart;独立用户会话、单次订单、余额、幂等一致;只读 rootfs/UID/卷检查通过
未知版本启动拒绝 未知 engine_version 正常返回 error,两次重开均释放连接和锁,无清理 panic
注释/Markdown 15 个 Markdown 的本地链接及代码围栏配对通过;Go 类型/函数和主要 TS 组件补说明
Compose 配置 config –quiet 语法/环境校验通过

遇到的问题和修复#

  1. 默认 Go module proxy 超时:改用可访问镜像完成下载,未关闭 module 校验;驱动升级要求 Go 1.26,使用自动匹配工具链。服务启动读取 SQLite 版本并拒绝未包含要求 WAL 修复的版本。
  2. 行情初版扫描全部活动订单:改为投影事务内维护聚合 levels,以 ticks 有序读取前 20 档;多个 WS 复用一个采样快照。
  3. 核心初版幂等摘要包含 JSON 编码:将规范化摘要计算移到外围,日志保存摘要,恢复由外围兼容补齐;核心只比较摘要和更新状态。
  4. Playwright 暴露 label 的单位/option 文字影响可访问名称:加入准确 aria-label 后完整联调通过。
  5. npm 审计发现初选 Vite/Playwright 旧版本问题:升级固定版本后审计为零。
  6. 标准多阶段 Docker 构建失败:主机配置的 docker.mirrors.ustc.edu.cn 无法解析。未修改用户 Docker daemon;提供 Dockerfile.runtime 使用已验证本地产物,单独验证容器运行。标准 Dockerfile 的在线构建尚未成功验证。
  7. 注释梳理发现 OpenStore 具名返回值清理缺陷:return nil, err 令 s 变 nil,旧 defer 再访问会 panic。改为捕获已打开实例,加入真实未知版本拒绝及重复开锁验证。
  8. 前端异步刷新可能发生旧身份/旧请求晚到覆盖:加入会话引用与查询 generation 校验,轮询沿用最大已知 processed_seq;初始 HTTP 行情与 WS 都只接受不倒退水位,StrictMode 启动 effect 清理旧回调。私有组件按账号 key 重建,避免待确认请求跨身份复用。
  9. 核心最优价缓存替代每次树取极值;在现有每命令不变量中增加缓存与树极值一致断言。没有执行容量 benchmark,不能将算法改进称为吞吐实测。

复核命令与环境#

go test ./...
go test -race ./...
go vet ./...
npm --prefix frontend run build
npm --prefix frontend run format:check
# 以下在 frontend 目录执行
npm audit
E2E_URL=http://127.0.0.1:18080 npm run test:e2e
E2E_URL=http://127.0.0.1:18081 npm run test:e2e
# 回到根目录
CGO_ENABLED=0 go build -trimpath -o bin/exchange ./cmd/server
python3 scripts/crash_check.py
docker build -f Dockerfile.runtime -t exchange-demo:verified .
docker compose -f deploy/compose.yaml config --quiet

本地浏览器使用 /tmp/web3-development-e2e;容器为 web3-exchange-validation,端口 18081,独立命名卷 web3-exchange-validation-data,明确测试管理员。两次浏览器结果均 1 passed(本地 13.8s、容器 13.3s,包含 runner 时间);纯测试场景分别 11.3s/11.0s,不是吞吐成绩。容器重启核验由 Python CookieJar 保持同一会话,创建挂单后记录余额,重启后以原键确认同单/余额不变,并取消自己的测试挂单。资源检查用 docker inspect 与 /app/exchange health。

停止自己启动的本地测试进程及验证容器,保留 /tmp 测试数据与 Docker volume 供复查;无云资源、无 Git 提交,报告不伪造部署实例或 hash。

未执行与边界#

未做完整容量压测/长时运行/真实断电、全部 failpoint 矩阵、云服务器实机部署、完整升级回滚演练、在线备份 CLI、生成客户端一致性。Dockerfile 基础镜像尚未锁 digest。未知请求目前仅前端组件内存保留,刷新/卸载后无法恢复;未验证数据集重置的行情 epoch。当前 INPUT/去重历史持续增长,查询列表有固定上限,只有 ETH-USDT,非生产交易系统。

截图路径(本地生成,未版本化):playwright-results/terminal.png、admin.png、mobile.png。后续报告记录代码提交;当前目录尚未初始化 Git,不能编造提交 hash。

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