Solidity结构体数组传递异常：Truffle测试无法获取数组数据

核心原因 #

最可能的问题是字段名不匹配：你合约里的结构体数组字段定义为space，但测试代码中错误地尝试访问spaceData，因此返回undefined。另外，Truffle对Solidity固定大小数组的返回格式处理有特定逻辑，若未正确解析也会导致数组无法获取。

分步解决 #

1. 核对合约与测试的字段名一致性 #

先确认Solidity合约的结构体定义，确保字段名无误：

pragma solidity ^0.8.0;

contract UniverseContract {
    struct Universe {
        uint256 year;
        uint64[3] space; // 数组字段名为space
    }

    mapping(address => Universe) public myUni;

    function setSomething(address _addr, uint256 _year, uint64[3] calldata _space) external {
        myUni[_addr] = Universe(_year, _space);
    }
}

测试代码中必须使用space而非spaceData来访问数组字段。

2. 正确解析Truffle返回的结构体数据 #

Truffle调用public mapping的getter时，返回的是按结构体字段顺序排列的数组，而非直接的对象。需通过解构或索引获取数据：

// Truffle测试代码示例
const UniverseContract = artifacts.require("UniverseContract");

contract("UniverseContract", accounts => {
  it("should fetch full struct data including space array", async () => {
    const contractInstance = await UniverseContract.deployed();
    // 准备测试数据（uint64对应JS的BigInt）
    const testYear = 2024n;
    const testSpace = [1n, 2n, 3n];
    
    await contractInstance.setSomething(accounts[0], testYear, testSpace);
    
    // 获取结构体数据：返回格式为 [year值, [space数组元素]]
    const [retrievedYear, retrievedSpace] = await contractInstance.myUni(accounts[0]);
    
    console.log("Year:", retrievedYear.toString());
    console.log("Space array:", retrievedSpace.map(item => item.toString()));
  });
});

若你期望通过对象字段名访问，可手动将返回数组转为对象：

const structArray = await contractInstance.myUni(accounts[0]);
const myPassedData = {
  year: structArray[0],
  space: structArray[1]
};
// 此时可通过myPassedData.space访问数组

3. 版本兼容性注意 #

旧版本Truffle对Solidity结构体的支持有限，若使用的Truffle版本较老，建议升级到v5.x及以上版本，以更好地处理结构体和固定大小数组的返回格式。

额外提示 #

• Solidity的uint64类型在JavaScript中需用BigInt处理，避免因数值超出Number范围导致的精度丢失。
• 确保测试代码中所有异步操作都使用await，避免因Promise未解析而拿到非预期的结果。

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