Azure Pipelines部署静态Web应用突发超时问题排查求助

使用Azure Pipelines构建并部署React应用至Azure Static Web Apps，采用微软托管代理（ubuntu-latest）运行CI/CD流水线。近两日出现以下异常：

• 原本4-5分钟完成的npm安装与构建任务，现在耗时20-25分钟
• AzureStaticWebApp@0部署任务原耗时4-5分钟，现需15-20分钟以上，触发默认15分钟超时限制
• 未对代码做任何修改

相关任务配置如下：

- script: |
      npm install
      npm run build --prod --if-present
    displayName: 'npm install and build'


  - task: AzureStaticWebApp@0
    inputs:
      app_location: '/'
      api_location: 'api'
      output_location: ''
      azure_static_web_apps_api_token: $(AZURE_STATIC_WEB_APPS_API_TOKEN_UAT)
      skip_app_build: false
    displayName: 'Deploy to UAT Static Web App'

更新：代理详情与之前任务快速运行时一致

一、npm安装构建耗时增加的原因与解决 #

1. 微软托管代理资源/网络负载异常 #

• 原因：ubuntu-latest代理池近期可能出现资源紧张、网络拥堵，导致npm包下载速度骤降
• 解决：
  • 切换至其他版本的托管代理（如ubuntu-22.04或ubuntu-20.04），测试是否恢复正常速度
  • 启用npm缓存，复用已下载的依赖包，避免重复下载。示例配置：

    - task: Cache@2
      inputs:
        key: 'npm | "$(Agent.OS)" | package-lock.json'
        restoreKeys: |
           npm | "$(Agent.OS)"
        path: $(npm_config_cache)
      displayName: 'Cache npm dependencies'
    

  • 改用npm ci替代npm install，npm ci严格按照package-lock.json安装，跳过依赖解析环节，速度更快且更稳定

2. npm源或依赖包CDN访问异常 #

• 原因：默认npm源（registry.npmjs.org）可能出现区域访问延迟或故障
• 解决：
  • 在npm install前临时切换至国内镜像源，命令如下：

    npm config set registry https://registry.npmmirror.com/
    

  • 检查package.json中依赖包的访问状态，确认所有依赖都能正常下载

二、AzureStaticWebApp@0任务超时的原因与解决 #

1. 目标区域Azure服务负载过高 #

• 原因：UAT环境所在的Azure区域近期可能有服务维护或流量峰值，导致部署流程变慢
• 解决：
  • 查看Azure门户的服务健康页面，确认目标区域是否有异常公告
  • 避开高峰时段手动触发部署，观察耗时是否恢复

2. 重复构建导致额外耗时 #

• 原因：AzureStaticWebApp@0任务中skip_app_build设为false，会在部署环节再次执行构建，和之前的script步骤重复，双倍消耗时间
• 解决：
  • 将skip_app_build改为true，复用之前script步骤生成的构建产物。修改后的任务配置：

    - task: AzureStaticWebApp@0
      inputs:
        app_location: '/'
        api_location: 'api'
        output_location: 'build' # 填写React实际构建输出目录，通常为build或dist
        azure_static_web_apps_api_token: $(AZURE_STATIC_WEB_APPS_API_TOKEN_UAT)
        skip_app_build: true
      displayName: 'Deploy to UAT Static Web App'
    

  • 确保npm run build已正确生成产物，且output_location与构建输出目录一致

3. API服务部署的额外耗时 #

• 原因：api_location配置的目录可能有大量依赖或复杂构建逻辑，导致API部分处理耗时增加
• 解决：
  • 单独检查API项目的构建耗时，确认是否有依赖更新或逻辑异常
  • 如果本次部署无需更新API，可临时将api_location设为空，跳过API部署环节测试速度

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