将Express API部署至Azure App Service的问题咨询

老哥，我帮你梳理下本地Git部署Express应用到Azure App Service时最容易踩的坑和对应的解决办法，你可以对照着一步步排查：

1. 先确认Azure端的核心配置是否正确 #

• 检查运行时堆栈：在Azure门户进入你的应用服务 → 设置 → 配置 → 常规设置，确保运行时堆栈选的是Node.js，而且版本和你本地开发用的尽量一致（比如18.x、20.x）。这步错了的话，哪怕代码没问题，部署后也跑不起来。
• 核对部署凭据：推送时要用Azure生成的部署凭据（不是你的微软账户密码），可以在应用服务 → 部署中心 → 本地Git里查看或重置这个凭据，输错了会导致推送失败。

2. 本地项目的关键配置调整 #

• 确认package.json的启动脚本：Azure部署时会自动执行npm install和npm start，所以你的package.json里必须有start脚本，比如：

  "scripts": {
    "start": "node server.js"
  }
  

  你用generator-express-no-stress生成的项目，默认启动脚本可能是npm run start或者其他，要确保和Azure的预期一致。
• 添加web.config（Windows环境必加）：如果你的App Service是Windows操作系统，必须在项目根目录放一个web.config文件，告诉IIS如何处理Node.js请求，内容如下：

  <?xml version="1.0" encoding="utf-8"?>
  <configuration>
    <system.webServer>
      <handlers>
        <add name="iisnode" path="server.js" verb="*" modules="iisnode"/>
      </handlers>
      <rewrite>
        <rules>
          <rule name="NodeInspector" patternSyntax="ECMAScript" stopProcessing="true">
            <match url="^server.js\/debug[\/]?" />
          </rule>
          <rule name="StaticContent">
            <action type="Rewrite" url="public{REQUEST_URI}"/>
          </rule>
          <rule name="DynamicContent">
            <conditions>
              <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="True"/>
            </conditions>
            <action type="Rewrite" url="server.js"/>
          </rule>
        </rules>
      </rewrite>
      <iisnode node_env="production" />
    </system.webServer>
  </configuration>
  

  把这个文件提交到Git后再推送。
• 检查端口设置：Azure会给Node.js应用分配环境变量PORT，所以你的Express应用不能硬编码端口（比如3000），要改成：

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

  不过generator-express-no-stress生成的项目应该已经处理了这个，还是确认下更稳妥。

3. 查看日志定位具体错误 #

如果推送还是失败，一定要看日志找原因：

• 部署日志：在Azure门户的应用服务 → 部署中心 → 日志里，能看到详细的部署过程，比如npm安装失败、脚本执行错误等具体信息。
• Kudu控制台：访问https://<你的应用名称>.scm.azurewebsites.net，进入Debug Console → PowerShell（或Bash），可以直接查看项目文件、日志文件（比如D:\home\LogFiles下的日志），能更直观地找到问题所在。

4. 其他常见坑点 #

• 编译类依赖问题：如果你的项目依赖了需要编译的包（比如node-sass），要确保Azure的运行环境支持，或者在package.json里添加postinstall脚本处理编译，避免生产环境安装依赖时跳过必要步骤。
• .gitignore检查：别把package.json、package-lock.json这类关键文件加到.gitignore里，不然Azure拿到代码后没法安装依赖。

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