Vite应用集成谷歌云文本转语音时出现Buffer重复声明语法错误

云上老周

2026-7-10

解决Vite中NodeGlobalsPolyfillPlugin与google-cloud-text-to-speech的Buffer冲突问题

这个错误是因为NodeGlobalsPolyfillPlugin和google-cloud-text-to-speech都在代码中声明了Buffer变量，导致全局作用域里出现重复声明的语法冲突。以下是几种可行的解决办法：

1. 调整NodeGlobalsPolyfillPlugin的Buffer配置

如果你的项目不需要通过该插件手动注入Buffer，直接关闭它的Buffer polyfill：

// vite.config.js
import { NodeGlobalsPolyfillPlugin } from '@esbuild-plugins/node-globals-polyfill';

export default {
  plugins: [
    NodeGlobalsPolyfillPlugin({
      buffer: false, // 关闭Buffer的自动注入
      // 保留你需要的其他全局变量polyfill，比如process等
    })
  ]
}

google-cloud-text-to-speech本身会处理Buffer的依赖，不需要额外通过插件注入。

2. 通过Vite的define配置统一Buffer引用

如果必须保留插件的Buffer polyfill，让库使用全局的Buffer而不是重新声明：

// vite.config.js
export default {
  define: {
    'Buffer': 'Buffer' // 将库内部的Buffer指向全局Buffer
  },
  // 其他原有配置
}

3. 替换为更精准的Rollup polyfill插件

用@rollup/plugin-node-polyfills替代NodeGlobalsPolyfillPlugin，可以更细粒度控制polyfill的注入，避免重复：
首先安装依赖：

npm install @rollup/plugin-node-polyfills --save-dev

然后修改配置：

// vite.config.js
import nodePolyfills from '@rollup/plugin-node-polyfills';

export default {
  plugins: [
    nodePolyfills({
      include: ['buffer'] // 仅按需polyfill需要的模块
    })
  ],
  resolve: {
    alias: {
      buffer: 'rollup-plugin-node-polyfills/polyfills/buffer-es6'
    }
  }
}