Web3 交易系统
零基础入门

09|页面卡住时,怎样判断真实结果

前一站:源码阅读 · 下一站:练习和自测

1. 分层判断,不靠一个绿色提示#

正常流程里 UI、SQL、消息和链很快会一致,看起来像一个步骤。故障时它们可能暂时不同步。先问当前在哪层:请求没受理、资格已占用、签名没完成、交易未入块、入块失败、确认未到、索引落后,还是已经确认但页面读取失败。

排障目标是找证据恢复原动作,不是删掉不理解的状态让页面重新开始。

2. 刷新页面不是第二次购买#

前端保存原请求键、数据集、钱包/活动上下文和交易观察信息,并通过后端查询所属钱包资格恢复。sessionStorage 属于当前标签页的恢复材料,不是资金权威,也不是永不丢失的数据库。

签名或发送前切换钱包/活动,晚到响应可能属于旧上下文。页面使用上下文与请求顺序保护,避免 A 的资格显示到 B;恢复完成前不盲目发新请求。关闭存储能力时也不能继续发送一个无法可靠追踪的写操作。

3. 典型现象怎么理解#

现象 可能含义 先看什么
ready 非 200 链落后、被冻结、SQL/队列或预算异常 Go 日志、健康、确认块和积压
SIGN_PENDING 持续 outbox、broker、job 或 signer 尚未完成 SQL outbox/job、RabbitMQ 连接与 Worker 错误
CLAIMABLE 但余额未变 只有凭证,还未购买 allowance、购买交易和 Gas
有 hash 一直等待 未入块、失败、确认未到或 RPC/索引落后 receipt、块高度和索引游标
倒计时为 0 仍 held 未满足同确认块的过期证据 块时间、consumed 和规范 hash
队列 Ready=0 可能已交接给 SQL,也可能本就无任务 inbox/job、资格和链状态
页面显示暂停核查 持久冻结,需要核对矛盾或深重组 原始日志、块锚点、只读对账
新一轮页面找不到旧资格 链和 dataset 已重建 本轮配置、数据目录和浏览器上下文

完整排障见运行手册,不要把模拟系统的 exchangectl 用到发售 SQL 或链任务库。

4. 为什么“宁可暂时不回收”#

假设资格截止 12:00,用户在链时间 11:59:59 买成功,但网站 RPC 断了。如果网站看本地 12:00 就释放库存,B 可能拿到一个与已购买事实冲突的新资格。

因此安全回收要等链证据证明此前未消费且之后已不可能按旧期限执行。本项目检查确认块时间、同 hash consumed、规范块和持久锚点;无法核实就不释放。这是正确性与短期可用库存之间的明确取舍。

5. 重组为什么特殊#

浅重组可能发生在确认等待中,发送任务需要重新观察原交易;已写入确认索引的块变化,则触发更保守的深重组处理。发售持久冻结数据集,链交易也有停止与人工核对边界。

不能自动把已经确认的资产与订单反向改一遍就宣称恢复:外部钱包和后续操作可能已经依赖原结果。当前项目没有实现通用重组回滚或自动修账。

6. 测试是怎样分层的#

层级 主要证明什么 不能替代什么
Go/前端单元 规则、单位、不变量、纯函数和非法输入 真 broker、真链和浏览器流程
SQLite/PG 组件 事务、唯一约束、迁移和状态竞争 公共链共识或生产数据库容量
RabbitMQ 集成 confirm、重投、ack、重连和死信 用户已购买或所有故障可恢复
Anvil 合约 验签、转币、回滚、重复购买和限制 独立安全审计或所有恶意代币兼容
全链路集成 Go + DB + 中间件 + 链的协作和崩溃窗口 云部署、高可用和长期容量
浏览器 E2E 点击、移动布局、刷新、身份切换和真实余额变化 所有钱包扩展或恶劣网络场景
性能/恢复实验 特定环境、负载和故障条件的表现 可以脱离环境引用的生产 TPS

报告中“通过”只对应当时执行范围。历史 Kafka 环境不能改名成 RabbitMQ 成绩,模拟撮合每秒处理量不能充当链上最终成交吞吐。

7. 如何开始跑测试#

先读发售测试说明。轻量入口可以在根目录执行:

go test ./flashsale ./messaging
go vet ./flashsale ./messaging

外部 PG/RabbitMQ 用例可能根据环境变量跳过;看到命令通过后仍要看输出中的实际执行/跳过范围。前端脚本需要对应平台依赖已安装;Windows 一键模式把依赖放在 staging,不要直接假定仓库中的 node_modules 可在 Windows 运行。

真实中间件、Anvil、故障和浏览器验证有专门脚本,会创建隔离数据、保留证据,并可能重建测试链。第一次不要边手动交易边随手运行全部故障脚本;按测试说明在独立环境执行。

8. 手动验收做四组观察#

正常购买:检查精确币差、资格终态、库存等式和刷新恢复。

最后一份:A 占住时 B 不能领;同钱包/同键刷新不重复扣库存。它验证本地竞争场景,不替代成千上万并发的压力曲线。

过期演练:倒计时结束后等待链核验,B 可领回收额度,A 不能重领本场。

购买后交易:A 挂卖、B 签买,最终两单成交、任务确认,币差与事件可查。

这些步骤详见验收手册。读阶段报告可以看到历史失败、更正与后续回归;文档整理没有重新跑业务测试。

9. 自测#

问:能不能把一条 held 资格直接删掉解锁?答:不能。有效签名可能仍在用户手里,删除 SQL 不会撤销链上授权,还会破坏库存、幂等和审计关系。

问:对账 differences=[] 是否等于生产安全?答:不等于。它只在检查覆盖的同一水位与链锚点上没有发现差异,不是安全审计、储备证明或容量验证。

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