使用@ethereumjs构建区块时遭遇invalid transaction trie错误求助

环境版本 #

使用的ethereumjs包版本如下：

"@ethereumjs/block": "^5.0.1",
"@ethereumjs/blockchain": "^7.0.1",
"@ethereumjs/common": "^4.1.0",
"@ethereumjs/tx": "^5.1.0",
"@ethereumjs/vm": "^7.1.0",
"@ethereumjs/util": "^9.0.1"

触发的错误 #

运行代码时持续抛出以下错误：

Error: invalid transaction trie (block number=1 hash=0xd837b21b15426eedcd23ceb3658edfc04563d5e9c9ad6962c7da56106fb7cbfc hf=shanghai baseFeePerGas=7 txs=6 uncles=0)
    at Block.validateData (D:\github\node_modules\@ethereumjs\block\src\block.ts:550:13)
    at async Blockchain.validateBlock (D:\github\node_modules\@ethereumjs\blockchain\src\blockchain.ts:657:5)
    at async D:\github\node_modules\@ethereumjs\blockchain\src\blockchain.ts:493:11
    at async Blockchain.runWithLock (D:\github\node_modules\@ethereumjs\blockchain\src\blockchain.ts:296:21)
    at async Blockchain._putBlockOrHeader (D:\github\node_modules\@ethereumjs\blockchain\src\blockchain.ts:454:5)
    at async Blockchain.putBlock (D:\github\node_modules\@ethereumjs\blockchain\src\blockchain.ts:385:5)
    at async createBlocks (D:\github\test.ts:80:5)

代码逻辑为：创建账户→生成签名交易→构建区块并调用genTxTrie→存入区块链，目前疑惑为何传入交易后无法生成正确的交易前缀树。

排查方向 #

1. 交易签名与序列化正确性 #

• 检查交易签名流程：使用@ethereumjs/tx创建交易后，必须确保调用了sign()方法完成签名，且签名私钥与发起账户匹配。
• 确认交易序列化格式：将交易加入区块前，需使用serialize()获取正确的RLP序列化数据，或确保传入区块的是已签名的Transaction实例，而非未处理的原始对象。
• 验证交易gas参数：检查每个交易的gasLimit、gasPrice（或EIP-1559的maxFeePerGas/maxPriorityFeePerGas）是否符合上海硬分叉规则，参数不合法会导致trie生成异常。

2. genTxTrie调用时机与上下文 #

• 确保在添加所有交易到区块后再调用genTxTrie()：若先调用方法再添加交易，会导致trie与实际交易列表不匹配，触发校验失败。
• 检查区块构造参数：创建Block实例时，需传入指定上海硬分叉的common配置，否则交易RLP编码规则不匹配，会导致trie根计算错误。
• 确认genTxTrie返回值：调用后可打印区块的txTrie根哈希，手动对比交易列表的RLP哈希计算结果，验证是否一致。

3. 区块数据的完整性校验 #

• 检查区块transactions数组：确保无重复交易、空交易或格式错误的交易对象混入。
• 验证区块头transactionsRoot：调用genTxTrie后，区块头的transactionsRoot会自动更新，需确认该值与交易trie根哈希一致，若不一致则说明trie生成过程存在问题。
• 核对硬分叉配置：确保common实例正确启用shanghai硬分叉，不同分叉下的交易结构（如EIP-1559支持）会影响trie生成逻辑。

4. 区块链存储与锁机制 #

• 保证putBlock调用时无并发冲突：runWithLock的报错提示可能存在并发操作冲突，需确保区块写入串行执行。
• 检查存储路径：若使用磁盘存储，确保路径有读写权限，且之前的区块数据无损坏，可尝试清空存储目录后重新测试。

内容的提问来源于stack exchange，提问作者Darksorrow