MERN项目部署至Azure Web App后无法运行的问题求助

1. 解决Node.js版本不兼容问题 #

• 先确认Azure Web App支持的Node.js稳定版本列表，将项目package.json里的engines字段修改为Azure支持的20.x版本（比如20.14.0，需匹配Azure的支持范围）：

  "engines": {
    "node": "20.14.0"
  }
  

• 部署后在Azure门户的「配置」>「常规设置」里，手动指定Node.js版本为你修改后的兼容版本，避免使用默认的20.9.0。

2. 修复bcrypt安装失败/找不到的问题 #

bcrypt是原生编译模块，Windows环境下依赖特定构建工具链，Azure默认环境可能不满足，推荐两种解决方式：

• 改用bcryptjs替代：这是纯JavaScript实现的版本，无需编译，API和bcrypt完全兼容。执行以下命令替换：

  npm uninstall bcrypt
  npm install bcryptjs
  

  之后把代码里所有require('bcrypt')或import bcrypt from 'bcrypt'替换成require('bcryptjs')或import bcrypt from 'bcryptjs'即可，不用改业务逻辑。
• 坚持使用bcrypt的话：
  1. 本地Windows环境先安装全局构建工具：npm install --global windows-build-tools
  2. 本地安装bcrypt时强制从源码构建：npm install bcrypt --build-from-source
  3. 修改.gitignore，移除对node_modules的忽略，把本地编译好的node_modules一起部署到Azure，避免Azure环境重新编译失败。

3. 排查HTTP 500错误 #

500错误大概率是服务器端未捕获的异常，按以下步骤定位：

• 登录Azure门户，进入「监控」>「日志」，查看应用的详细日志，搜索错误栈信息，找到具体报错的代码位置。
• 确保后端服务使用Azure指定的端口：不要硬写固定端口，改用环境变量获取端口：

  const port = process.env.PORT || 3000;
  app.listen(port, () => {
    console.log(`Server running on port ${port}`);
  });
  

• 检查前端静态资源配置：React Vite构建后的文件要放到后端的静态资源目录（比如public文件夹），同时确保后端配置了静态文件服务：

  const path = require('path');
  app.use(express.static(path.join(__dirname, 'public')));
  

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