如何修复部署ExpressJS应用到Heroku时的bcrypt相关启动错误

看起来你遇到的是bcrypt跨环境编译的经典问题！错误里的invalid ELF header说明你本地编译的bcrypt二进制文件（bcrypt_lib.node）和Heroku的Linux环境不兼容——毕竟ELF是Linux专属的可执行文件格式，如果你是在Windows/macOS上开发的，本地生成的二进制肯定没法在Heroku上跑。加上Heroku返回的H10状态码，就是因为这个二进制文件加载失败直接导致应用崩溃了。

下面给你几个可行的解决方案，按推荐程度排序：

方案一：清除本地编译产物，让Heroku重新编译 #

这是最常用的修复方式，核心是不让本地的编译产物被提交到Git，让Heroku在它自己的环境里重新编译bcrypt：

• 先删除本地的node_modules文件夹和package-lock.json（用yarn的话就删yarn.lock）
• 确保这些文件已经加入.gitignore（没加的话赶紧加）：

  node_modules/
  package-lock.json
  yarn.lock
  

• 提交修改到Git：

  git add .gitignore
  git rm -r --cached node_modules
  git commit -m "Remove local dependencies to fix bcross-environment bcrypt compilation"
  

• 重新部署到Heroku：

  git push heroku main
  

Heroku部署时会自动重新安装依赖，并针对它的Linux环境编译bcrypt，生成兼容的二进制文件。

方案二：改用bcryptjs替代原生bcrypt #

如果你不想折腾编译的问题，bcryptjs是纯JavaScript实现的版本，不需要编译二进制文件，兼容性拉满，用法和bcrypt几乎完全一致：

• 卸载原生bcrypt：

  npm uninstall bcrypt
  

• 安装bcryptjs：

  npm install bcryptjs
  

• 把代码里所有require('bcrypt')改成require('bcryptjs')，其他加密、比对的逻辑完全不用改
• 提交修改后重新部署即可

方案三：配置Heroku编译环境（进阶） #

如果你一定要用原生bcrypt，可以在项目根目录创建.npmrc文件，加入以下配置，强制Heroku在安装时以root权限编译依赖：

unsafe-perm=true

提交这个文件后重新部署，Heroku就能正确编译出适配自身环境的bcrypt二进制文件了。

另外提个小建议：你的server.js里app.listen放在了中间件和路由挂载之前，虽然大部分情况没问题，但建议调整顺序，把启动服务器的代码放到最后，避免偶尔出现路由不生效的情况：

const express = require('express')
const bodyParser = require('body-parser')
const cors = require('cors')
const app = express()

// 先挂载中间件和路由
app.use(cors())
app.use(bodyParser.json({limit: "500mb"}));
app.use(bodyParser.urlencoded({limit: "500mb", extended: true, parameterLimit:50000}));
app.use('/api',require('./routes/api'))

// 最后启动服务器
app.listen(process.env.PORT || 3000,function(){
 console.log('server has been started')
})

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