Windows Azure App Service运行Node.js应用提示需手动安装sqlite3如何解决

1. 修正Node模块解析路径 #

Azure App Service 上的 iisnode 运行时可能存在工作目录偏移问题，导致 Node 无法正确识别项目下的 node_modules 目录：

• 在项目入口文件（如server.js）最顶部添加代码，确认模块查找路径是否包含项目根目录的 node_modules：

console.log(module.paths);

• 如路径缺失，手动添加模块查找路径：

const path = require('path');
module.paths.unshift(path.resolve(__dirname, 'node_modules'));

2. 手动传入sqlite3模块给Sequelize #

绕过 Sequelize 内部的模块加载逻辑，提前手动引入 sqlite3 后直接传入配置项：

import * as sqlite3 from 'sqlite3';
import { Sequelize } from 'sequelize-typescript';

const sequelize = new Sequelize({
  dialect: 'sqlite',
  storage: './你的数据库文件路径.db',
  dialectModule: sqlite3, // 直接传入已加载的sqlite3实例
  // 其余原有配置保持不变
});

3. 适配Windows平台原生二进制包 #

sqlite3 依赖平台特定的二进制文件，Azure App Service 默认使用32位Node.js运行时，本地打包的二进制包可能不匹配：

• 在 package.json 中添加安装钩子，强制下载对应架构的二进制包：

"scripts": {
  "install": "node-pre-gyp install --fallback-to-build --target_platform=win32 --target_arch=ia32 --target=14.16.0"
}

如果你的App Service开启了64位支持，将target_arch改为x64即可。

4. 调整Azure App Service配置 #

• 进入Azure门户的App Service配置页，确认WEBSITE_NODE_DEFAULT_VERSION严格设置为14.16.0
• 关闭WEBSITE_RUN_FROM_PACKAGE选项，该选项会将文件系统设为只读，导致原生模块加载权限不足
• 在Azure控制台执行命令授权sqlite3目录读取执行权限：
  icacls node_modules\sqlite3 /grant Everyone:RX

5. 替换无原生依赖的sqlite实现 #

如果上述方案均无效，可以将sqlite3替换为纯JavaScript实现的sql.js或者@vlcn.io/crsqlite-wasm，二者不存在原生二进制依赖，无需适配平台架构，仅需对应调整Sequelize的dialect配置即可正常使用。

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