GitHub Action「Publish to Chromatic」超时错误排查求助

针对大量代码变更后Chromatic Action 10分钟超时、本地构建正常的情况，可尝试以下方案：

• 延长Action步骤超时时间
  GitHub Action默认单步超时为10分钟，直接在Chromatic步骤中设置更长的超时阈值：

  - name: Publish to Chromatic
    uses: chromaui/action@v1
    timeout-minutes: 30
    with:
      projectToken: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
  

• 拆分构建与上传流程
  将Storybook本地构建和Chromatic上传拆分为两个独立步骤，避免单步任务过重：

  - name: Build Storybook locally
    run: npm run build-storybook
  - name: Publish built Storybook to Chromatic
    uses: chromaui/action@v1
    timeout-minutes: 20
    with:
      projectToken: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
      buildScriptName: "" # 跳过Chromatic内置构建，使用已生成的静态文件
  

• 优化Chromatic扫描范围
  添加--only-changed参数，仅检测与基线相比有变更的组件，大幅减少扫描和渲染量：

  - name: Publish to Chromatic
    uses: chromaui/action@v1
    with:
      projectToken: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
      flags: --only-changed
  

• 升级GitHub Runner规格
  默认的GitHub Ubuntu runner资源有限，换成更高配置的runner提升构建速度：

  jobs:
    chromatic:
      runs-on: ubuntu-latest-4core # 4核CPU runner，比默认2核更快
      steps:
        # ... 拉代码、安装依赖等步骤
  

• 清理依赖缓存
  过期的依赖缓存可能导致安装或构建异常缓慢，强制清理后重新安装：

  - name: Clear npm cache
    run: npm cache clean --force
  - name: Install fresh dependencies
    run: npm install
  

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