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

6.9 KiB

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,使反射调用匹配生产方法当前的三个参数。未修改任何生产业务逻辑或配置。