Web3 v4.1.1后端初始化报错：TypeError: Web3 is not a constructor

问题原因 #

Web3 v4.x版本调整了导出机制，不再提供默认导出，而是采用命名导出。你之前的代码用默认导入方式调用构造函数，因此触发类型错误。

解决步骤 #

1. 修正导入语句 #

根据项目模块系统选择对应导入方式：

• CommonJS（Node.js默认环境）：

  const { Web3 } = require('web3');
  

• ES模块（需在package.json中设置"type": "module"）：

  import { Web3 } from 'web3';
  

2. 正确初始化Web3实例 #

修正导入后，初始化代码即可正常运行：

const { Web3 } = require('web3');
const web3 = new Web3(process.env.INFURA_URL);

3. 配置公司自有钱包完成区块链交互 #

要实现后端用公司钱包处理所有链上操作，需加载钱包私钥并完成交易签名：

const { Web3 } = require('web3');
const web3 = new Web3(process.env.INFURA_URL);

// 加载公司钱包私钥（务必通过环境变量存储，禁止硬编码）
const companyPrivateKey = process.env.COMPANY_WALLET_PRIVATE_KEY;
const companyAccount = web3.eth.accounts.privateKeyToAccount(companyPrivateKey);

// 示例：发送ETH交易
async function sendCompanyTransaction() {
  const txConfig = {
    to: '0x目标地址',
    value: web3.utils.toWei('0.1', 'ether'),
    gas: 21000,
    gasPrice: await web3.eth.getGasPrice(),
    nonce: await web3.eth.getTransactionCount(companyAccount.address)
  };

  // 用公司账户签名交易
  const signedTx = await companyAccount.signTransaction(txConfig);
  // 广播已签名交易
  const txReceipt = await web3.eth.sendSignedTransaction(signedTx.rawTransaction);
  console.log('交易完成，哈希:', txReceipt.transactionHash);
}

sendCompanyTransaction().catch(console.error);

关键注意事项 #

• 私钥是核心敏感信息，必须通过环境变量或专业密钥管理服务存储，禁止暴露在代码或版本控制系统中。
• 确认Infura URL对应目标区块链网络（如主网、Sepolia测试网等）。
• 执行交易前需确保公司钱包有足够的Gas费用余额。

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