← 返回文档列表
放大镜下的空白回执,旁有金色晶体及红色关闭、青色开启的通道

资源已到账但转账仍失败,怎样读 TRON 交易回执?

先找实际转账的交易 ID,再区分广播、已固化确认与合约执行结果。按回执判断 REVERT、OUT_OF_ENERGY 或结果未明,避免重复付款和盲目补购。

Lunaria Miri Energy

资源到账与转账成功是两件事

能量已显示在发送地址,只能说明查询时该地址有相应资源,不能证明某笔 USDT TRC-20 转账已经成功。租赁交付记录与代币转账各自对应不同事件;排查时要看实际转账的交易 ID(txID),不要拿付款或资源委托记录代替。

先在可信钱包或区块浏览器核对网络、发送方和这次代币转账。下文使用 TRON 官方字段名,不假定任何钱包或平台具有某个按钮。

先确认交易,再看执行回执

广播响应 result: true 只表示这次广播调用未报告错误,不代表交易已确认或合约执行成功。GetTransactionById 返回交易本体;GetTransactionInfoById 返回执行后的费用、资源消耗、状态和日志,两者不能互相替代。

需要最终确认时,使用已固化数据:/walletsolidity/gettransactionbyid 查询交易本体,合约交易再看 /walletsolidity/gettransactioninfobyid 的回执。/wallet 接口提供节点当前最新视图,不等同于已固化结果。普通读者可请可信钱包支持协助核对这些状态,无需签名或转账来查询。

按结果分支处理

  • 查不到回执或缺少关键结果:先记为结果未明,保留原 txID 继续查询。一次空响应不是失败证据;先核对已固化交易本体是否存在,不立即重新付款。
  • 已取得已固化合约回执:先确认顶层 result 不为 FAILED,再检查 receipt.result。SUCCESS 表示合约执行成功;确认代币转账还要核对对应代币、收款方、金额及相关转账日志,不能只看资源到账。
  • REVERT:合约执行回退,可能是合约条件未满足。结合 contractResult 和错误说明排查;返回数据不一定包含可读原因,不能据此断言只是缺能量。
  • OUT_OF_ENERGY:执行时能量不足,结合当时资源、TRX 和 fee_limit 重新估算。其他错误按具体回执排查,不把所有失败都当成再买能量即可解决。

记录证据后再决定下一步

在自己的私密记录中保留查询时间与网络、原 txID、已固化状态、receipt.result、错误说明和资源消耗。不要向公开群发送未脱敏截图、完整地址或付款资料;查询回执不需要助记词或私钥。

教学情境:当前能量充足,但原转账回执为 REVERT,应检查合约条件,而不是仅追加能量。原交易结果未明时继续查原记录;确认失败并修正原因后,才评估是否发起新交易。资源后来到账不会改写已执行交易的结果;失败也不等于没有消耗资源或费用。

参考资料