Azure App Service部署NodeJS应用遇500错误：ES6转ES5后部署异常

我之前也踩过一模一样的坑——本地用Babel把ES6转成ES5跑的好好的，一部署到Azure App Service就弹出500错误，查了半天发现核心问题是Azure的部署流程没触发Babel编译，或者编译后的代码没被正确加载。下面是我亲测有效的排查和解决步骤：

1. 先确认package.json的脚本配置是否到位 #

首先检查你的package.json里的scripts字段，必须要有明确的编译和启动命令，比如：

"scripts": {
  "build": "babel src --out-dir dist", // 把src下的ES6代码编译到dist目录
  "start": "node dist/index.js" // 启动编译后的ES5代码，别直接跑原ES6文件！
}

这里一定要注意start命令指向的是编译后的文件，而不是你写的ES6源码文件。

2. 让Azure在部署时自动执行编译命令 #

Azure默认只会在部署时跑npm install，不会主动执行npm run build，这就是本地没问题但部署后报错的关键原因。你可以用两种方式解决：

• 方式一：用deploy.cmd自定义部署流程
  在项目根目录新建deploy.cmd文件，写入以下内容（根据你的脚本调整）：

@echo off
echo Installing dependencies...
npm install
echo Building project with Babel...
npm run build

Azure部署时会自动执行这个脚本，先装依赖再编译。

• 方式二：GitHub Actions部署时加build步骤
  如果是用GitHub Actions做CI/CD，直接在你的workflow文件里加一步编译：

- name: Install dependencies
  run: npm install
- name: Build project with Babel
  run: npm run build

这样部署到Azure的就是已经编译好的ES5代码了。

3. 手动指定Azure的启动命令 #

有时候Azure会无视你package.json里的start命令，直接去跑根目录的index.js（也就是你的ES6源码），这时候就得手动配置：

1. 登录Azure Portal，找到你的App Service实例
2. 进入「配置」>「常规设置」>「启动命令」
3. 输入npm run start或者直接写node dist/index.js，保存后重启应用

4. 检查编译产物是否被正确部署 #

如果是本地编译后上传，要确保.gitignore里没有把dist目录排除掉；如果是远程编译，去Azure的「部署中心」看部署日志，确认npm run build有没有被执行，dist目录有没有生成。要是日志里没看到build步骤，那肯定是部署流程没配置对。

5. 锁定Node.js版本避免兼容问题 #

虽然用了Babel，但如果Azure用的Node版本太老，也可能出现奇怪的兼容问题。你可以在package.json里指定Node版本：

"engines": {
  "node": ">=16.x"
}

Azure会自动匹配你指定的版本，减少版本差异带来的问题。

最后，每次修改配置后记得重启App Service，并且打开Azure的「日志流」看实时错误信息，能帮你快速定位问题。按这些步骤来，应该就能解决部署后的500错误了。

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