Ethers.js v6 中 BigNumberish 参数错误的解决方案-js教程-PHP中文网

Ethers.js v6 中 BigNumberish 参数错误的解决方案

本文详解 ethers.js v6 升级后因 approve 等合约方法要求严格 BigNumberish 类型（如 BigInt）而导致的 INVALID_ARGUMENT 错误，并提供兼容写法、最佳实践与避坑指南。

本文详解 ethers.js v6 升级后因 `approve` 等合约方法要求严格 `bignumberish` 类型（如 `bigint`）而导致的 `invalid_argument` 错误，并提供兼容写法、最佳实践与避坑指南。

在 ethers.js v6 中，所有涉及链上数值（如 amount、gasLimit、value）的参数均被强制要求为 BigNumberish 类型——即 number、string、bigint、BigNumber 或带 hex/type 字段的兼容对象。但关键点在于：普通 JavaScript number 类型在超出安全整数范围（2^53 - 1）时会丢失精度，因此 v6 默认拒绝裸 number 字面量（如 6500000000000000），即使它未超限，也会因类型校验失败而抛出 INVALID_ARGUMENT 错误。

你遇到的报错：

TypeError: invalid BigNumberish value (argument="value", value={ "hex": "0xb3e3", "type": "BigNumber" }, ...)

表面看 value 是一个合法 BigNumber 对象，实则根源常在于：你在调用 approve(...) 时传入了非 BigNumberish 类型的 amount（例如 JS number），而 ethers 内部在构造交易时尝试将其转换为 BigNumber 的过程中，意外接收了一个已被污染或结构异常的对象（如从旧版缓存、调试日志误传的 BigNumber 实例），触发了类型断言失败。

✅ 正确做法是：显式使用 BigInt 字符串构造或 ethers.parseUnits 等工具函数生成合规值。

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

✅ 推荐写法（v6 兼容且安全）

import { Contract, JsonRpcProvider, parseUnits } from "ethers";

const provider = new JsonRpcProvider(PROVIDER_URL);
const approvalContract = new Contract(wethAddress, erc20Abi, provider);

// ✅ 方式 1：使用 BigInt 字符串（最直接，适合已知精确数值）
await approvalContract.connect(wallet).approve(
  routerAddress,
  BigInt("6500000000000000") // ← 必须是字符串转 BigInt，不可写 BigInt(6500000000000000)
);

// ✅ 方式 2：使用 ethers 内置工具（推荐用于代币金额，自动处理小数位）
// 假设 WETH 小数位为 18，则 "0.0000065" ETH = 6500000000000000 wei
await approvalContract.connect(wallet).approve(
  routerAddress,
  parseUnits("0.0000065", 18) // 返回 BigNumber，100% 兼容
);

⚠️ 注意事项与常见陷阱

❌ 错误示范：

approve(routerAddress, 6500000000000000);           // 普通 number → 触发 INVALID_ARGUMENT
approve(routerAddress, BigInt(6500000000000000)); // BigInt() 不接受 number 参数 → TypeError

✅ 正确构造 BigInt：必须传入字符串：BigInt("6500000000000000")
（JS BigInt 构造函数不支持数字字面量，仅支持字符串或 bigint）
? 显式指定函数签名（进阶场景）：
当 ABI 中存在重载函数（如多个 approve）时，可显式调用以避免解析歧义：
```
await approvalContract.connect(wallet)["approve(address,uint256)"](
  routerAddress,
  parseUnits("0.0000065", 18)
);
```
注：签名中 uint256 无需空格，括号为英文半角；此写法在 v6+ 中稳定支持。

? 调试建议：
在传参前打印类型验证：

const amount = parseUnits("0.0000065", 18);
console.log("amount type:", typeof amount, "isBigNumber:", amount instanceof BigNumber);
// 输出应为: "object" true

✅ 总结

场景	推荐方案
精确 wei 值（如 gas、固定 wei）	BigInt("1234567890123456789")
代币金额（含小数）	parseUnits("1.23", decimals)（自动转为 BigNumber）
动态计算结果	先用 parseUnits 或 BigInt() 构造，再参与运算，全程避免裸 number