部署Azure静态Web应用时Bitbucket流水线卡在「Building」状态

核心排查方向及修复方案 #

• 路径配置冗余问题
  流水线默认工作目录就是$BITBUCKET_CLONE_DIR，你的APP_LOCATION和OUTPUT_LOCATION前缀重复，可简化为相对路径：

  APP_LOCATION: 'norius-lp'
  OUTPUT_LOCATION: 'norius-lp/dist/norius-lp/browser'
  

  建议在pipe前加路径验证步骤，确认目录存在：

  - ls -la norius-lp
  - ls -la norius-lp/dist/norius-lp/browser
  

• 权限命令合理性
  执行chown -R 165536:165536 $BITBUCKET_CLONE_DIR可能过度修改权限，若你的项目构建未生成特殊权限文件，可直接移除这条命令；如果是构建后文件权限异常，建议在构建完成后再针对性调整权限。

• 部署令牌有效性
  确认API_TOKEN是Azure静态Web应用的有效部署令牌，未过期且权限正确。务必用Bitbucket的加密变量存储令牌，不要明文写在配置中，避免泄露风险。

• Pipe版本稳定性
  使用main分支的pipe可能存在不稳定情况，建议指定稳定版本号，例如：

  pipe: microsoft/azure-static-web-apps-deploy:1.0.1
  

• 开启详细日志定位
  进入Bitbucket流水线设置，开启详细日志模式，查看pipe执行阶段的具体报错信息（如路径不存在、权限拒绝、网络超时等），这是定位停滞原因最直接的方式。

内容的提问来源于stack exchange，提问作者leandro.starke