Azure App Service部署Node.js应用突发故障求助

排查步骤 #

• 确认部署时的依赖安装配置
  • 前往App Service的部署中心，检查部署流程是否包含npm install步骤。若使用Zip部署，需在应用设置中添加SCM_DO_BUILD_DURING_DEPLOYMENT=true，强制部署过程自动安装依赖。
• 校验依赖一致性
  • 确保package.json和package-lock.json（或yarn.lock）已完整提交至代码仓库，避免生产环境依赖版本与本地不符。
  • 本地执行npm ci模拟生产环境依赖安装，排查是否存在依赖声明缺失问题。
• 检查文件结构与路径
  • 通过Kudu高级工具（https://<你的应用名>.scm.azurewebsites.net）进入控制台，查看site/wwwroot目录：
    • 确认node_modules目录存在且包含所需包（如express）
    • 验证./routes/users对应文件是否存在，注意Linux环境区分大小写，若本地为Windows开发需检查路径大小写是否匹配
• 调整应用环境配置
  • 在配置 > 应用设置中：
    • 确认NODE_ENV设置为production，且所有运行依赖均在package.json的dependencies中（而非devDependencies）
    • 添加WEBSITE_NODE_DEFAULT_VERSION指定与本地一致的Node.js版本（如18.x）
• 手动清理与重装
  • 在Kudu控制台执行以下命令：

    rm -rf node_modules package-lock.json
    npm install
    

  • 执行完成后重启App Service，验证故障是否解决

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