如何从Bitbucket部署Node.js应用到Azure？Azure端npm安装问题求助

我之前也碰到过一模一样的困扰！Bitbucket这边的Pipelines流程跑起来顺得不行，但把源码推到Azure后，直接报Internal Server Error说找不到依赖——核心问题就是Azure默认不会自动帮你执行npm install，得我们自己想办法补这个步骤。给你几个亲测有效的解决方案：

方案一：在Bitbucket Pipelines里提前构建好再部署 #

既然Azure不想装依赖，那我们就把依赖安装和项目构建的步骤都在Bitbucket的Pipeline里完成，只把成品文件传到Azure。这样既快又能避免环境不一致的问题。

修改你的bitbucket-pipelines.yml，加上安装依赖和构建的步骤：

image: node:18 # 选和Azure一致的Node版本

pipelines:
  default:
    - step:
        name: 构建并部署到Azure
        script:
          - npm install --production # 只装生产依赖，减小打包体积
          - npm run build # 如果是React/Vue这类需要编译的项目，加上这步
          - zip -r app.zip ./* # 打包所有必要文件（包括node_modules、dist、package.json等）
          - # 用Azure CLI部署zip包，先确保已经配置好Azure的认证
          - az webapp deployment source config-zip --resource-group <你的资源组名> --name <你的WebApp名> --src app.zip

方案二：让Azure部署后自动执行npm install #

如果不想在Pipeline里打包，也可以让Azure在接收到源码后自动跑安装命令。有两种方式：

方式A：通过Azure门户设置部署后脚本 #

1. 登录Azure门户，打开你的Web App
2. 进入「部署中心」→「设置」
3. 在「部署后脚本」里输入：npm install
4. 保存后，下次部署时Azure就会自动执行这个命令

方式B：添加.deployment配置文件 #

在你的项目根目录创建一个.deployment文件，内容如下：

[config]
command = npm install && npm start

把这个文件和源码一起推到Bitbucket，Azure部署时会读取这个文件并执行指定命令。

方案三：开启Azure App Service的自动化构建 #

Azure自带了针对Node.js项目的自动化构建能力，开启后它会自动识别package.json，执行npm install甚至构建命令：

1. 打开Azure门户的Web App→「部署中心」
2. 在「生成自动化」选项里选择「启用」
3. 保存设置，之后每次部署Azure都会自动处理依赖安装

额外注意事项 #

• 确保Azure的Node.js版本和你Bitbucket Pipeline里的版本一致（在Azure门户的「配置」→「常规设置」里可以修改），避免依赖兼容性问题
• 如果项目用到私有npm包，要在Azure的「配置」→「应用程序设置」里添加NPM_TOKEN环境变量，值为你的npm私有仓库令牌
• 用Azure CLI部署时，要确保Bitbucket Pipeline里已经配置了Azure的服务主体认证，避免权限问题

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