Vite+SvelteKit使用adapter-node构建报Buffer未导出错误

'Buffer' is not exported by __vite-browser-external:buffer 这个报错的核心是依赖Node内置Buffer对象的代码被错误纳入了客户端构建链路。Vite在客户端构建时默认会把所有Node内置模块标记为外部引用、不会主动打包，你之前配置的polyfill没生效，是因为SvelteKit对Vite的构建配置做了服务端/客户端分层，直接写在Vite配置顶层的optimizeDeps、Rollup插件规则不会按预期生效，反而会和SvelteKit自身的构建逻辑冲突。
另外你用的是adapter-node适配器，服务端构建产物本来就跑在Node环境里，原生支持Buffer，根本不需要给服务端代码打Node相关polyfill，乱加polyfill反而会干扰正常的模块解析。

• 先做代码运行环境隔离
  所有仅在服务端运行的逻辑（比如接口处理、服务端工具方法、调用Node原生API的代码），统一放到*.server.js/ts文件或者src/lib/server目录下，SvelteKit会自动把这部分代码排除在客户端bundle之外，从根源上避免服务端代码进入客户端构建流程。
  如果确实有逻辑需要在客户端侧用到Buffer，不要依赖全局polyfill注入，直接显式安装浏览器兼容的buffer包：

  npm install buffer
  

  在用到Buffer的文件顶部显式导入即可，不需要全局挂载：

  import { Buffer } from 'buffer'
  

• 清理无效的Vite配置
  把你之前写在optimizeDeps.esbuildOptions.plugins、build.rollupOptions.plugins里的所有Node polyfill相关插件全部删掉，这些配置是给纯客户端SPA项目准备的，在SvelteKit项目里只会添乱。
  只需要在vite.config.js/ts里加一行别名配置，把客户端侧的buffer引用指向你安装的npm包即可：

  import { sveltekit } from '@sveltejs/kit/vite'
  import { defineConfig } from 'vite'
  
  export default defineConfig({
    plugins: [sveltekit()],
    resolve: {
      alias: {
        buffer: 'buffer/index.js'
      }
    }
  })
  

• 处理第三方依赖导致的报错
  如果报错来自node_modules里的第三方包，在svelte.config.js里给adapter-node添加外部依赖配置，标记仅服务端用的依赖为外部模块，不让Vite尝试把它打包进客户端产物：

  import adapter from '@sveltejs/adapter-node'
  import { vitePreprocess } from '@sveltejs/kit/vite'
  
  /** @type {import('@sveltejs/kit').Config} */
  const config = {
    preprocess: vitePreprocess(),
    kit: {
      adapter: adapter({
        // 把依赖Buffer、仅在服务端运行的第三方包名加到这个数组
        external: []
      })
    }
  }
  
  export default config
  

排查优先级：先查代码环境隔离，再调配置。绝大多数同类型报错都是因为把本该跑在服务端的代码写到了通用逻辑文件里，导致被客户端构建逻辑扫到，上来就堆polyfill是走弯路。

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