Azure DevOps部署Node.js Express项目遇内部服务器错误求助

通过Azure DevOps发布Node.js Express项目，构建与发布流程均显示执行成功，但访问部署链接时出现「因发生内部服务器错误，无法显示页面」的报错。本人仅为项目贡献者，无Azure门户创建/修改权限，怀疑问题源于门户配置，已尝试将所有构建文件部署至SCM\wwwroot目录。

当前构建YAML配置 #

pool:
  name: Azure Pipelines
steps:
- task: NodeTool@0
  displayName: 'Use Node 14.x'
  inputs:
    versionSpec: 14.x
- task: Npm@1
  displayName: 'npm install'
  inputs:
    verbose: false
- task: Npm@1
  displayName: 'npm custom'
  inputs:
    command: custom
    verbose: false
    customCommand: 'run build'
- task: PublishBuildArtifacts@1
  displayName: 'Publish Artifact: drop'
  inputs:
    PathtoPublish: '$(System.DefaultWorkingDirectory)'

同时附带以下相关截图：

• Package Script配置截图
• Webpack.config配置截图
• Azure Pipeline执行详情截图
• Azure Release执行详情截图
• wwwroot目录结构截图

排查建议 #

1. 检查应用服务启动命令
   确认Azure门户中应用服务的「配置>常规设置>启动命令」是否正确设置。Express项目通常需要指定启动入口，比如node server.js或npm start，缺失或路径错误会直接导致启动失败。

2. 查看应用日志
   通过Azure门户的「监测>日志流」或Kudu控制台（https://<你的应用名>.scm.azurewebsites.net/DebugConsole）查看具体错误日志，500错误基本都会在日志中给出明确原因，比如依赖缺失、端口冲突、文件路径错误等。

3. 验证部署文件完整性
   在Kudu控制台的site\wwwroot目录下，确认所有必要文件已部署：

   • 打包后的代码目录（如dist）
   • package.json及对应的锁文件（package-lock.json/yarn.lock）
   • 项目启动入口文件（如server.js/app.js）
     如果构建产物仅包含dist目录，需确保启动命令指向dist内的入口文件。

4. 检查端口配置
   Express项目不要硬编码端口，必须使用环境变量process.env.PORT，Azure应用服务会自动分配端口，硬编码会导致端口冲突无法启动服务。

5. 确认依赖安装情况
   若发布流程中未在目标服务器执行依赖安装，需检查构建阶段是否已将node_modules打包进产物，或在发布任务中添加依赖安装步骤。生产环境建议使用npm ci替代npm install，保证依赖版本与开发环境一致。

内容的提问来源于stack exchange，提问作者Jose Jeino Solivio