post-install-cmd脚本超时由PHP的max_execution_time控制，非Composer的process-timeout；常见原因包括artisan命令卡顿、autoload失败或CI系统级限制，需通过php -d max_execution_time=0或set_time_limit(0)解决，并排查memory_limit与外部命令超时。
post-install-cmd 脚本超时由 PHP 控制，不是 Composer 的 process-timeout
错误里出现 PHP Fatal error: Maximum execution time of 300 seconds exceeded 或脚本静默中断，说明是 PHP 自身的执行时限在起作用，和 process-timeout 完全无关。Composer 只负责启动脚本进程，不干预其内部运行。
常见诱因包括：Laravel 的 php artisan config:cache 扫描大量配置、自定义构建脚本加载大文件、或脚本里调用了未安装的 dev-only 工具（如 phpstan）导致卡在 autoload 阶段。
- 临时解决：用
php -d max_execution_time=0 composer install启动整个 Composer 进程，让所有脚本不受限 - 长期方案：在脚本入口第一行加
set_time_limit(0)，但必须确保它没被后续代码覆盖（比如某些框架初始化会重设） - CI 环境中注意：
max_execution_time可能被disable_functions禁用，此时set_time_limit()会直接报错，需检查php -i | grep disable_functions
为什么加了 --no-interaction 还卡住？
很多脚本（比如 php artisan key:generate）在非交互模式下仍可能等待 stdin，尤其当环境变量缺失或配置未就位时。错误不会明说“waiting for input”，而是表现为无响应或超时。
验证方法：手动运行脚本命令，加上 --no-interaction --quiet，看是否真能秒出结果；若仍卡住，说明问题不在交互，而在逻辑本身（如数据库连接未配置、缓存驱动不可用）。
- 强制跳过交互依赖：在脚本前加
export APP_KEY=base64:...避免生成密钥环节 - 拆解脚本逐条测试：把
post-install-cmd数组里的每条命令单独跑一遍，定位具体哪一行挂住 - 避免在脚本里调用未声明为
require-dev的工具——--no-dev时它们根本不存在，脚本会卡在class not found
CI 中脚本超时还受哪些隐藏限制？
即使 PHP 和 Composer 层面都调高了时限，CI 流水线仍可能提前杀掉进程。这不是配置没生效，而是被更高层截断了。
GitHub Actions 默认单 job 最长运行 6 小时，但自建 runner 常设 20 分钟硬限制；Docker 容器若用 timeout 600 composer install 包裹，实际超时由外层 timeout 决定，Composer 根本没机会响应自己的超时设置。
- 检查 runner 级别限制：GitHub Actions 查
runs-on类型的文档，GitLab CI 看timeout字段是否全局设置 - Docker 场景下，确认
docker run没带--stop-timeout，且宿主机没启用 systemd 的DefaultLimitCPU类限制 - 内存不足常伪装成超时：Composer 解析锁文件时 peak memory 达 1.5G+，
memory_limit=-1比单纯调时间更治本
脚本里调外部命令（如 git clone）超时怎么算？
如果脚本里自己执行了 exec('git clone ...') 或 shell_exec('unzip ...')，这部分超时由 process-timeout 控制，和 PHP 的 max_execution_time 是两套机制。
也就是说，一个脚本整体运行了 400 秒，其中 380 秒花在 git clone 上——这时你得调高 process-timeout，而不是 PHP 的执行时限。
- 查清卡点：加
-vvv参数运行composer install，看最后一条输出是不是你脚本里发的 shell 命令 - 混合场景要双管齐下：脚本本身耗时长 → 调
max_execution_time；脚本里又调了慢命令 → 同时调process-timeout -
process-timeout设为 0 不推荐：一旦git clone因网络问题卡死，整个流程无法自动退出，CI 任务就永远 pending
