寻求Azure App Service部署Node.js服务器的准确最新官方文档

构建命令找不到的解决方法 #

• 确认项目根目录的package.json中存在对应脚本，示例：

  "scripts": {
    "build": "node build.js", // 根据你的项目调整，比如Next.js用`next build`
    "start": "node server.js"
  }
  

• 在Azure App Service控制台的配置 > 常规设置中，设置启动命令为npm start（若无需预构建直接启动服务）；若依赖预构建，确保CI/CD流程中已执行构建步骤，而非依赖App Service自动触发。
• 若使用Azure默认的Oryx构建工具，可在项目根目录添加.oryx-config.toml文件自定义构建逻辑：

  buildCommand = "npm run build"
  

内容无法获取的排查步骤 #

• 检查GitHub CI/CD工作流文件（通常为.github/workflows/azure-webapps-node.yml），确认部署步骤的上传路径正确：

  - name: 'Deploy to Azure Web App'
    uses: azure/webapps-deploy@v2
    with:
      app-name: '<你的应用名称>'
      slot-name: 'production'
      package: './dist' # 替换为你的构建产物目录，若无需构建则用'.'
  

• 登录Kudu控制台（https://<你的应用名称>.scm.azurewebsites.net/），查看site/wwwroot目录下是否存在完整的项目文件，若缺失则调整CI/CD的上传路径。
• 确保Node.js版本一致：Azure配置 > 常规设置中指定的Node.js版本，需与本地开发环境、CI/CD环境的版本匹配，避免依赖包兼容性问题。

环境变量与配置检查 #

• 在Azure配置 > 应用程序设置中添加的环境变量，需与项目中使用的变量名称完全一致，敏感变量可勾选“隐藏值”。
• 不要依赖本地的.env文件（不会被上传至仓库），需将环境变量直接配置在Azure中，或在CI/CD流程中注入。

适配最新版本的标准部署流程 #

1. 初始化Node.js项目，确保package.json包含start脚本（必填）和build脚本（按需）。
2. 在Azure门户创建App Service实例，选择对应版本的Node.js运行时。
3. 配置GitHub CI/CD：
   • 在App Service的部署中心选择GitHub，授权后关联目标仓库和分支。
   • Azure会自动生成工作流文件，可根据项目需求修改构建命令、部署产物目录等参数。
4. 验证部署：触发CI/CD后查看工作流日志定位错误；部署成功后访问应用URL，确认内容正常加载。

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