Github Actions执行composer install安装依赖被取消报错如何解决

报错信息 #

Run composer install -q --no-ansi --no-interaction --no-scripts
--no-progress --prefer-dist composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist shell: /usr/bin/bash -e {0} Error: The operation was canceled.

报错原因排查 #

• 静默模式屏蔽底层错误：命令中添加了-q参数，所有执行日志和报错信息被隐藏，无法判断是依赖冲突、网络问题还是权限异常，触发任务直接取消
• 缓存规则冲突：工作流同时配置了Composer全局缓存和vendor目录缓存，两类缓存的校验逻辑冲突，导致依赖安装步骤触发异常终止
• 网络超时：Github Actions runner访问官方Composer源网络不稳定，长时间无响应被系统自动取消
• 依赖版本不匹配：部分子依赖的版本要求和矩阵配置的PHP 7.4/8.0环境不兼容，静默模式下直接终止执行
• 执行时长超限：依赖包体积较大时，默认的步骤超时时间不够，安装未完成就被强制取消

可行解决方案 #

按优先级执行以下操作即可解决问题：

1. 关闭静默模式打印详细日志
   修改依赖安装步骤的命令，去掉静默参数、添加日志输出，先定位具体报错原因：

composer install -vvv --no-ansi --no-interaction --no-scripts --prefer-dist

移除原命令中的-q和--no-progress参数，添加-vvv打印全量执行日志。

2. 优化缓存逻辑删除冗余配置
   删除重复的vendor目录缓存配置，仅保留Composer全局缓存即可避免两类缓存冲突：
   移除工作流中以下配置段：

- name: Cache PHP dependencies
  uses: actions/cache@v2
  id: vendor-cache
  with:
    path: vendor
    key: ${{ runner.OS }}-build-${{ hashFiles('**/composer.lock') }}

同时删除Install Dependencies步骤中的if: steps.vendor-cache.outputs.cache-hit != 'true'判断条件。

3. 配置Composer镜像加速避免网络超时
   在依赖安装步骤前新增源配置步骤，使用国内镜像提升访问稳定性：

- name: Config Composer Mirror
  run: composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

4. 适配矩阵参数+延长超时时间
   匹配工作流矩阵中的依赖稳定性配置，同时延长步骤超时时间避免大依赖安装未完成被终止：

- name: Install Dependencies
  run: composer install -vvv --no-ansi --no-interaction --no-scripts --prefer-dist --${{ matrix.dependency-stability }}
  timeout-minutes: 15

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