getrawtransaction为何查不到交易？

getrawtransaction 查不到已确认交易，常见原因不是交易不存在，而是节点没有 txindex，也没有收到包含该交易的 blockhash。理解 mempool、索引和区块提示三条路径，能避免为一个查询错误重建或重发交易。

从索引状态到区块哈希逐层查

1. 先用 getmempoolentry 判断本节点 mempool 是否有 txid。
2. 若已确认，从区块浏览器或索引取得 blockhash，再显式查询。
3. 需要任意历史查询时检查 getindexinfo 的 txindex 状态，不只看配置文件。
4. 保存 raw hex 与 verbose 解码，核对输入输出、blockHash 和 confirmations。

默认查询覆盖哪些交易

未提供 blockhash 时，节点可直接返回当前 mempool 交易；对已确认历史，通常需要启用并同步 txindex。钱包相关交易另有 wallet 索引，gettransaction 能查到并不保证 getrawtransaction 在无 txindex 时也能查。

节点为什么会回答未找到

1. 默认查询覆盖哪些交易：getrawtransaction默认可查询内存池交易；查询任意已确认交易通常需要txindex，或显式提供包含该交易的blockhash。
2. 提供 blockhash 可缩小查找范围：verbose=false返回序列化十六进制，verbose=true返回vin、vout、size、vsize、weight与确认信息。
3. txid、hash、size 与 vsize 别混：getrawtransaction面向链上原始交易，钱包自己的交易应结合gettransaction；查不到不等于交易从未存在。

提供 blockhash 可缩小查找范围

已知交易所在区块且节点保有该区块时，显式 blockhash 允许在该区块查找。verbose 结果中的 in_active_chain 只在提供 blockhash 时有意义，可帮助识别给定区块是否仍在主链。

另一节点能返回交易时

节点正在建立 txindex 时，配置已经开启但索引尚未同步，查询仍可能失败。运维页面应显示索引 best_block_height 或同步状态，不能只显示“txindex=true”。

txid、hash、size 与 vsize 别混

SegWit 交易的 txid 不包含 witness，hash 通常对应包含 witness 的标识；size 是序列化字节，vsize 按 weight 折算。做手续费率时用 vsize，做网络传输或存储分析时再看 size 和 weight。

网络与历史范围不明就不下结论

来源 blockhash 不可信、节点已裁剪目标数据或交易标识无法在第二来源确认时，不据此判断支付失败。

先定义节点的数据保留契约

节点查询策略应先定义数据保留契约：是否启用 txindex、是否允许提供 blockhash、是否只需要钱包相关交易，以及历史区块是否被裁剪。应用收到“未找到”时，把参数、节点版本、索引状态和区块范围写入诊断记录，再决定换索引节点或补充 blockhash。若第二来源能返回交易，还应核对原始字节和所在区块，避免把测试网或同名服务结果混入主网。

getrawtransaction官方说明

1. Bitcoin Developer Reference：用于核对Bitcoin Core getrawtransaction的候选主题的一手字段、产品说明或事件发现。
2. Bitcoin RPC Index：用于核对Bitcoin Core getrawtransaction的实现路径、交叉验证或风险边界。

相关站内主题：原始交易结构、UTXO检查。资料访问时间为2026-07-22；协议、接口、监管清单与产品界面均可能更新。

风险提示：RPC返回未找到不等于交易从链上消失，索引、裁剪、网络和Blockhash参数都可能造成同一现象。涉及支付争议时应使用第二节点交叉核对原始交易与区块；本文不替代完整节点证据保全。