Files
usdt/docs/mainnet-nonbroadcast-test-report-2026-11-07.md
T
2026-11-07 06:50:14 -05:00

126 lines
6.9 KiB
Markdown

# MAINNET 非广播功能测试报告
测试日期:2026-11-07
测试范围:支付系统、资源租赁逻辑、链上执行器、TRON MAINNET 只读链路。
明确排除:真实资源购买、租赁订单创建、钱包解锁、交易签名、交易广播及生产数据库写入。
## 1. 结论
当前代码的支付、租赁和执行器核心逻辑测试总体通过,TRON MAINNET 的 TronGrid 与 TronScan 只读接口实测可用。执行器 HTTPS 入口可达且拒绝非白名单来源,但由于测试工作站不在执行器允许来源中,无法从本机完成已部署执行器的 readiness 验证。
尚不能据此宣布主网全链路正式通过。剩余主网验证包括:真实 INTERNAL/DUIYA 报价、真实资源下单与到账、执行器从支付服务器来源的 readiness、主网签名和小额广播。这些步骤需要在生产同等网络和凭据环境中执行,其中下单和广播需要单独授权。
## 2. 安全边界
本轮未调用以下接口或能力:
- DUIYA `/buy_energy`、`/buy_net`。
- INTERNAL `/api/rental/v1/create`。
- 任何钱包解锁和真实签名。
- TRON `broadcasttransaction` 或等价广播接口。
- 已部署支付/租赁系统的生产数据库写操作。
测试日志中出现的“创建”“签名”“广播”均来自 H2、mock HTTP 或 fake chain,不连接真实链和真实供应商。
## 3. 自动化测试结果
### 3.1 `ruoyi-system`
命令使用 JDK 8 执行 Maven 测试。
| 项目 | 结果 |
| --- | --- |
| 唯一测试数 | 257 |
| 按设计跳过 | 4 |
| 业务失败 | 0 |
| 首轮环境性异常 | 1 个 TLS 本地夹具超时 |
| TLS 单独复跑 | 2/2 通过 |
已覆盖:
- 链上任务路由、状态持久化、未签名任务恢复、SIGNED 重播规则。
- 资源预检、按地址互斥、租赁授权、费用上限、幂等防重复下单。
- INTERNAL 与 DUIYA 请求格式、鉴权、报价和查询响应解析(本地 mock)。
- 支付订单、代付订单、回调、充值、提现、结算和时区处理。
- 租赁 HMAC、nonce 防重放、节点派单、资源核验、历史采集和清理。
- MAINNET/NILE 网络隔离及主网定价分支。
- 自签 TLS 证书加载、保留主机名校验、禁止远程证书 URL。
- TronGrid/TronScan 端点切换、限流和异常降级(本地 mock)。
TLS 用例首次在本地 `HttpsServer` 请求中超时,单独复跑 2/2 通过,暂定为本机测试夹具偶发问题。该结果应保留观察;若 CI 重复出现,应为本地 HTTPS server 配置独立线程池并增加稳定性测试。
### 3.2 `ruoyi-admin`
| 项目 | 结果 |
| --- | --- |
| 测试数 | 40 |
| 失败/异常/跳过 | 0/0/0 |
首次运行发现 `AggregationItemCancellationTest` 仍按旧的双参数方法签名做反射。生产方法已经增加 `Boolean resourceOnly` 参数,导致测试在进入业务逻辑前报 `NoSuchMethodException`。已仅更新测试签名和调用参数,未修改生产代码,复跑 40/40 通过。
覆盖内容包括归集取消与执行互斥、任务删除约束、支付任务、数据库时区、TOTP、订单权限和 Webhook 调试验签。
### 3.3 `usdt-chain-executor`
| 项目 | 结果 |
| --- | --- |
| 测试数 | 6 |
| 失败/异常/跳过 | 0/0/0 |
覆盖内容包括:
- 必填启动参数和广播开关保护。
- HTTP 监听、Bearer Token、TCP 来源 IP 白名单。
- connectivity、readiness 和空正文唤醒接口。
- 钱包配置口令或网络不匹配时拒绝 readiness。
- Protobuf 完整运行时检查,确认装载 `protobuf-java 3.25.5`,未装载冲突的 javalite 实现。
## 4. TRON MAINNET 真实只读测试
API Key 从现有配置在进程内读取,测试命令和报告均未输出凭据。
| 服务 | 检查 | HTTP | 结果 | 本次响应摘要 |
| --- | --- | --- | --- | --- |
| TronGrid | `wallet/getnowblock` | 200 | 通过 | 返回有效最新区块高度 |
| TronGrid | `wallet/getchainparameters` | 200 | 通过 | 返回 81 项链参数 |
| TronGrid | `wallet/getaccount` | 200 | 通过 | 返回与请求一致的主网地址 |
| TronGrid | `wallet/getaccountresource` | 200 | 通过 | 返回有效全网能量参数 |
| TronScan | `api/accountv2` | 200 | 通过 | 返回有效地址字段 |
这证明当前两套 API Key、DNS、TLS、主网 API 访问和基础响应格式可用。它不能替代长时间限流、故障切换和主网写操作测试。
## 5. 已部署执行器检查
从当前测试工作站访问配置中的 HTTPS 执行器:
| 路径 | 结果 | 解释 |
| --- | --- | --- |
| `/internal/v1/connectivity` | HTTP 403 | HTTPS 入口可达,访问被来源 IP 或 Bearer 防线拒绝。 |
| `/internal/v1/readiness` | HTTP 403 | 同上,尚未进入钱包口令/数据库就绪检查。 |
该结果符合执行器的安全设计,但不代表支付服务器到执行器的真实链路通过。应登录支付系统所在服务器,使用相同 Base URL 和受控 Token 执行 readiness,或在全局配置页点击“立即检查”。不要为了测试把执行器开放给所有来源。
## 6. 未覆盖与上线前必测
| 项目 | 当前状态 | 原因/下一步 |
| --- | --- | --- |
| INTERNAL MAINNET 真实报价 | 未实测 | 当前工作站没有租赁应用数据库凭据/API Secret;可在支付服务器执行只读 `/quote`。 |
| DUIYA MAINNET 真实报价 | 未实测 | 当前工作站没有解密后的平台凭据;只调用 `/query_price`,禁止调用购买接口。 |
| 平台真实订单查询 | 未实测 | 需要一张已有主网测试订单号,避免创建新订单。 |
| 资源到账确认 | 未实测 | 需要已有租赁订单和目标地址,比较下单前后链上资源。 |
| 支付服务器到执行器 readiness | 被白名单阻止 | 必须从白名单内的支付服务器执行。 |
| 主网资源购买 | 明确排除 | 会产生外部订单和费用,需要单独授权。 |
| 主网签名与广播 | 明确排除 | 用户本轮明确不测试实际广播。 |
## 7. 风险与建议
1. 当前 API Key 已通过对话和版本化配置出现,应尽快轮换,并改为部署环境变量或密钥管理服务注入。
2. `ruoyi-system` 的本地 TLS 测试出现一次偶发超时,虽然复跑通过,仍建议在 CI 连续执行多次观察稳定性。
3. 当前 Maven 版本较旧,测试依赖仍报告若干缺少 POM 元数据的本地制品警告;构建能完成,但应维护内部 Maven 仓库中的完整 POM。
4. 主网启用前至少完成一次“真实报价但不下单”,确认网络、套餐、数量步长、费用币种和费用上限。
5. 首次主网购买和广播应使用独立小额地址、最低数量、严格费用上限,并全程核对 `usdt_resource_preparation`、`usdt_resource_rental_order` 和 `usdt_chain_execution`。
## 8. 本轮代码变化
仅修改测试文件 `ruoyi-admin/src/test/java/com/ruoyi/web/controller/system/AggregationItemCancellationTest.java`,使反射调用匹配生产方法当前的三个参数。未修改任何生产业务逻辑或配置。