执行 composer install 或 composer update 时看到超时报错,第一反应往往是调大 process-timeout。但在多数 ci 环境里,超时只是表象,真正的原因可能在工作目录、扩展或依赖来源上。按下面顺序排查,比直接改数字更省时间。

先排除三类更常见的成因
第一,工作目录不对。GitHub Actions 中必须显式设置 working-directory 为工作区路径,或先 cd 到项目根目录,否则 composer 会在错误路径执行,报错信息容易被读成超时。第二,扩展缺失:ext-zip、ext-xml、ext-mbstring 缺任意一项,composer install 会直接退出,而不是慢慢等到超时。第三,私有 Git 包如果写成 git@github.com:user/repo,会绕过镜像直连,应改为 HTTPS 地址或配置 GIT_SSH_COMMAND。
超时值的优先级
确认路径与扩展无误后,再处理超时本身。环境变量 COMPOSER_PROCESS_TIMEOUT 的优先级最高,设为 1200 这类值可以覆盖插件与自定义 installer 启动的子进程,比 composer config -g 更可靠。要注意私有包的每次 git checkout 都会计入 process-timeout 的总耗时,不是单独计时;composer update 阶段建议 memory_limit 不低于 1.5G,因为把 process-timeout 设为 0 之后仍然失败,大概率是内存不足而非时限。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。

还有一个容易忽略的点:CI 容器重启后全局配置会丢失,写入 config -g 的值并不会随镜像保留,写进脚本开头的环境变量更稳妥。不同 Composer 版本与 CI 平台对环境变量的写法会有差异,落地前对照所用版本的文档确认一遍即可。

















