部署Node.js应用到Azure时SQLite版本不匹配问题

你遇到的是sqlite3这类原生Node模块的典型问题——它们和系统的Node版本、编译环境绑定得很紧，本地开发环境和部署环境的差异很容易导致版本不匹配。结合你的配置和情况，我给你几个针对性的解决步骤：

1. 对齐部署环境的Node与npm版本 #

你的package.json指定了node >=6.9.1和npm ^5.8.0，但本地用的是v9.8.0，部署环境的Node版本如果和本地差异过大，会导致sqlite3预编译的二进制包无法适配（这类包是和特定Node版本绑定的）。

• 登录部署服务器，执行node -v和npm -v确认版本是否符合要求，尽量和本地的v9.8.0接近（比如锁定9.x系列）。如果是PaaS平台部署，可把engines字段改得更明确：

  "engines": {
    "node": "9.x",
    "npm": "5.8.x"
  }
  

2. 不要直接上传本地的node_modules #

本地的node_modules是基于你的开发环境编译生成的，直接上传到部署环境会因为系统/Node版本差异导致sqlite3无法正常运行。

• 确保.gitignore文件里包含node_modules/和package-lock.json（避免锁死版本引发适配问题）
• 部署时，在目标环境执行npm install --production，让npm针对部署环境重新安装并编译所有依赖。

3. 确保部署环境具备编译工具链 #

sqlite3是原生模块，安装时需要编译源码，部署环境必须有对应的编译工具：

• 若为Ubuntu/Debian系统，执行：

  sudo apt-get update && sudo apt-get install build-essential python
  

• 若为CentOS/RHEL系统，执行：

  sudo yum install gcc-c++ make python
  

安装完工具后，重新执行npm install让sqlite3重新编译适配部署环境。

4. 强制从源码编译sqlite3 #

如果部署环境的Node版本和本地不同，预编译的二进制包可能不兼容，这时可以强制npm从源码编译：

npm install sqlite3 --build-from-source

也可以在package.json里添加安装脚本，自动触发源码编译：

"scripts": {
  "install": "npm install sqlite3 --build-from-source"
}

5. 确认sqlite3版本兼容性 #

你指定的sqlite3 ^4.0.0和Node v9.8.0是兼容的，但如果部署环境的Node版本低于v6.9.1，可能会出现兼容性问题。务必确认部署环境的Node版本符合engines字段的要求。

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