使用bitcoinjs-lib遇Cannot read properties of undefined(reading 'alloc')错误求助

API 探路者

2026-7-3

解决Vite+React项目中bitcoinjs-lib运行报错问题

错误原因

报错Cannot read properties of undefined (reading 'alloc')是因为bitcoinjs-lib依赖Node.js核心模块Buffer，但Vite默认在浏览器环境中不提供该模块的polyfill，导致运行时无法找到Buffer.alloc方法。

解决方案

1. 安装必要依赖

执行以下命令安装polyfill相关包：

npm install buffer vite-plugin-node-polyfills --save-dev

2. 配置Vite

修改项目根目录的vite.config.js，添加Node.js模块polyfill配置：

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import { nodePolyfills } from 'vite-plugin-node-polyfills';

export default defineConfig({
  plugins: [
    react(),
    nodePolyfills({
      include: ['buffer'],
      globals: {
        Buffer: true,
      },
    }),
  ],
});

3. 正确导入使用

可以保持原导入方式，或按需导入减少打包体积：

// 完整导入
import * as bitcoin from 'bitcoinjs-lib';

// 按需导入示例
import { payments, networks, ECPair } from 'bitcoinjs-lib';

// 测试示例：生成测试网P2PKH地址
const keyPair = ECPair.makeRandom();
const p2pkhAddress = payments.p2pkh({
  pubkey: keyPair.publicKey,
  network: networks.testnet
}).address;

console.log('测试网地址:', p2pkhAddress);