SvelteKit构建报错：无法解析已标记为external的mock-aws-s3等依赖

根因说明 #

你遇到的报错是原生C++模块bcrypt的依赖node-pre-gyp在构建阶段被vite的esbuild扫描到了其内部未安装的可选依赖导致，仅配置ssr.external无法覆盖esbuild的依赖解析规则。

方案1（推荐，零配置适配） #

直接替换bcrypt为纯JS实现的bcryptjs，两者API完全兼容，无任何原生依赖，可彻底规避构建问题：

• 卸载原生bcrypt：
  npm uninstall bcrypt
• 安装纯JS版本：
  npm install bcryptjs
• 全局替换所有代码中的import bcrypt from 'bcrypt'为import bcrypt from 'bcryptjs'即可，原有哈希、校验逻辑完全不需要修改。

方案2（保留原生bcrypt） #

如果需要原生bcrypt的性能优势，修改svelte.config.js的vite配置，同时覆盖esbuild和ssr的外部依赖规则：

kit: {
  // 其他原有配置不变
  vite: {
    optimizeDeps: {
      exclude: ['bcrypt']
    },
    // 新增esbuild外部依赖配置
    esbuild: {
      external: ['mock-aws-s3', 'aws-sdk', 'nock', 'node-pre-gyp', 'bcrypt']
    },
    ssr: {
      external: ['mock-aws-s3', 'aws-sdk', 'nock', 'node-pre-gyp', 'bcrypt']
    },
    // 其他原有配置不变
  }
}

同时在package.json的scripts字段中新增安装钩子，强制部署时从源码编译bcrypt二进制：

"scripts": {
  "install": "npm rebuild bcrypt --build-from-source",
  // 其他原有脚本不变
}

额外注意 #

确认所有bcrypt的调用都只出现在+page.server.js、+server.js等服务端专属文件中，不要写到客户端组件或同构运行的代码里，避免被打包到客户端bundle触发额外错误。

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