Web3 交易系统
测试与验收

发售测试与验收说明

手动步骤见验收手册,设计见架构。本轮证据统一写入项目根目录下的 docs/reports/evidence-sale-v0.6 ↗;历史 evidence-v0.5 和架构审阅报告不覆盖。

环境和层次#

本轮使用原生 Windows Go 1.26.9、Node 24.11.1、Anvil 1.4.4、Solidity 0.8.37、Edge headless;race 使用 WSL Ubuntu Go 1.26.9。PG/Redis/RabbitMQ 通过 WSL Docker 启动,AMQP 使用 5672,管理台 15672。不是公共测试网,也不是 MetaMask 扩展兼容测试。

层次 入口与断言
SQL 组件 flashsale/store_test.go:40 钱包争 5 份、重复请求、正文冲突、库存守恒、事件回滚/游标、签名、过期/重开
权限 一次性登录/重放、Origin/CSRF、Cookie、钱包私有资格
契约 contract_test.go:真实 handler 响应按 OpenAPI 校验,未领取 null、签发正文与 hash 上报
坏消息 格式错误即使 dataset 正确也持久隔离,不永久阻塞队列
AMQP messaging/rabbitmq_test.go:persistent/confirm、未 ack 重投、同适配器重连、Nack 死信
合约 contracts/tests/flashsale.test.mjs:真实 EVM 验签/错误域、金额/买方、授权失败原子回滚、暂停、重放、钱包限购、deadline、提取
集成 sale-check.mjs:登录 → SQL → outbox → 签名 → 真实 approve/purchase → 确认索引 → 精确资产差值
故障 硬杀重启、链不出块跨 deadline 不回收、恢复出块后安全回收、已确认深重组冻结
前端纯函数 46 个总用例,其中 2 个新增发售状态/错误用例
前端 E2E 禁用存储仍可读且阻止写;桌面购买/刷新恢复、390px 无横向溢出、售罄按钮、截图
跨业务 UI sale-trade.spec.ts:一键演示环境从购买跳转、A 卖出、B 买入、两单 FILLED
既有链模式回归 web3_check.mjs:RabbitMQ/PG/Redis 下成交/金额守恒、撤单、重复、恢复、历史/索引/对账、raw/hash/nonce 与重组

快速执行#

已安装依赖后,从项目根目录运行:

go test -count=1 ./...
go vet ./...
npm.cmd --prefix contracts run compile
npm.cmd --prefix contracts test
npm.cmd --prefix frontend run test:unit
npm.cmd --prefix frontend run sale:check
npm.cmd --prefix frontend run api:check
npm.cmd --prefix frontend run web3:check
npm.cmd --prefix frontend run format:check
npm.cmd --prefix frontend run build
# 独立随机端口、全新 Anvil 和 SQLite;包含真实浏览器
node scripts/sale-check.mjs --ui

Windows 浏览器测试默认使用已安装的 Edge。Linux/CI 设置 SALE_BROWSER_CHANNEL=chromium 并预先安装 Playwright Chromium。sale.spec.ts 需要 SALE_E2E=1;推荐通过 sale-check 自动建立独立服务,禁止指向现有用户数据直接消耗资格。

# 完整中间件(WSL Docker 示例;Docker Desktop 不设置 SALE_DOCKER_WSL)
$env:SALE_DOCKER_WSL='Ubuntu-22.04'
node scripts/sale-middleware.mjs --up
node scripts/sale-check.mjs --middleware --ui

# PG 实现同一组真实事务用例:每用例建独立随机 schema,结束仅清本用例 schema
$env:SALE_TEST_POSTGRES_DSN='postgres://exchange:local-web3-password@127.0.0.1:15432/exchange?sslmode=disable'
go test -v -count=1 ./flashsale
Remove-Item Env:SALE_TEST_POSTGRES_DSN

# 真实 RabbitMQ 传输
$env:RABBITMQ_TEST_URL='amqp://exchange:local-web3-password@127.0.0.1:5672/'
go test -v -count=1 ./messaging

# Linux race(WSL 的 Go 需已安装依赖)
wsl -d Ubuntu-22.04 -- /usr/local/go/bin/go test -race ./...

PG suite 有一个明确跳过项:SQLite 文件重开 fixture;该项在默认 SQLite suite 执行。AMQP 和 chaintrade 真实中间件测试在没有环境变量时明确 Skip,不代表已执行。Go 常规测试不自动启动 Docker。

二级市场完整中间件回归:

$env:WEB3_CHECK_POSTGRES_DSN = node --input-type=module -e "import {middlewareDatabase} from './scripts/sale-middleware.mjs'; console.log(await middlewareDatabase('trade_check'));"
$env:WEB3_CHECK_MIDDLEWARE='1'
$env:WEB3_CHECK_EVIDENCE_DIR='docs/reports/evidence-sale-v0.6/trade'
node scripts/web3_check.mjs

一键启动后,在本轮新建演示库验收购买后再交易:

$env:SALE_LAUNCHER_E2E='1'
$env:SALE_EVIDENCE=(Join-Path $PWD 'docs/reports/evidence-sale-v0.6')
npm.cmd --prefix frontend run test:e2e -- sale-trade.spec.ts

该用例会使用演示钱包 A 的首发资格,完成后手动验收请重新整体启动一轮。全局浏览器 E2E 默认会 Skip 发售专项,避免意外操作其他测试环境。

结果判定与证据#

证据 应看到
go-windows-final.txt 所有 Go 包通过;外部环境用例按配置 Skip
go-postgres-final.txt PG 事务/权限/契约/隔离通过,SQLite 重开明确 Skip
go-race-linux.txt 全包 race 通过
rabbitmq-transport.txt 真实 AMQP 传输测试通过
chaintrade-middleware-final.txt 二级交易真实 PG/Redis/RabbitMQ 的任务持久化、重试与去重通过
contracts-final.txt / frontend-final.txt 最终合约编译/测试、前端单元/契约/格式/构建日志
windows-launcher-check.json 一键完整模式两服务 ready=200、只读对账差异为空
sale-local.json / sale-middleware.json passed=true,所有检查与真实交易 hash;对账 differences=[]
sale-local-final.txt / sale-middleware-final.txt 独立链、浏览器用例与集成结果
sale-desktop.png / sale-mobile.png 实际页面截图,不是设计稿
sale-to-trade.png 实际二级市场最终成交
sale-to-trade-final.txt 最终 Windows 一键完整环境跨业务 UI 用例通过
trade/simulation-middleware-log.txt 二级市场真实服务日志
npm-audit-frontend.json / npm-audit-contracts.json 本次查询时零已知漏洞;不保证未来或已做安全审计

集成脚本会新建随机端口和临时数据目录,日志保存 data_dir。完整模式新建独立 PG 数据库和数据集队列,测试结束只停自己的服务/链,不删除历史数据/队列/卷。长期运行前人工清理自己确认无须保留的测试数据库和空队列。

曾失败的重组 fixture 记录为 sale-local-initial-reorg-fixture-failure.json:原因是测试使用 ethers 缓存块高,回退链后未填到原游标;改为原始 eth_blockNumber 后验证持久冻结。初次 Windows 问题见 windows-regression.txt;最新状态看 final 文件。

尚未证明的内容#

没有本轮长期容量/TPS/SLA、真实断电、公共链/云、生产 RabbitMQ 多节点故障、真实扩展钱包、备份整体恢复、安全审计成绩。Go race 常规执行不自动启用外部中间件;真实中间件另外跑功能集成。

Windows 目录同步适配只核验目录,文件仍各自 Sync,不能冒充 Unix 目录 fsync 的断电保证。符号链接测试 fixture 需要 Windows 开发者权限;无权限只完成其余 manifest 断言,Linux suite 覆盖符号链接拒绝。

npm 本轮修复 Vite 6.4.4(升级到 6.4.5)、minimatch(构建工具 override 11.0.1)和合约工具 follow-redirects 的审计问题,并重跑类型生成/编译/测试。具体锁文件是复现依据,不沿用历史“零漏洞”结论。

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