Composer如何排查pre脚本失败_Composer pre钩子修复步骤【排错】-composer-PHP中文网

composer pre-钩子失败时需加--verbose查看真实stderr输出，因其在autoload生成前运行，类不可用且错误易被静默；脚本须显式exit(1)或抛异常，避免路径、权限及递归调用陷阱。

composer如何排查pre脚本失败_composer pre钩子修复步骤【排错】

pre-钩子（如 pre-install-cmd、pre-update-cmd）失败时，Composer 默认不输出真实错误，只报 “Script xxx handling the yyy event returned with error code 1”——你得先让错误浮上来，再定位是路径、权限、autoload 还是提前退出的问题。

加 `--verbose` 看真实 stderr 输出

pre 钩子在 autoload 生成前就运行，很多类还不可用，PHP 错误（比如 Fatal error: Class 'Monolog\Logger' not found）会被静默吞掉。不加 -v 就像蒙眼修车。

必须重跑：例如 composer install -v 或 composer update --dry-run -v
注意输出里带 Executing command 的那行，后面紧跟着的就是脚本真实 stderr，包括 PHP Notice、Warning、file_get_contents(): failed to open stream
如果脚本是 PHP 类方法（如 My\Script::check），错误可能出现在 activate() 或构造函数里，-v 会显示插件加载过程，帮你确认是否走到那一步

检查脚本是否依赖未生成的 `vendor/autoload.php`

pre 钩子执行时机早于 autoload.php 生成，但很多人在脚本里直接 require 'vendor/autoload.php' 或 new 一个项目类——这必然失败。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

不要在 pre-install-cmd 或 pre-update-cmd 里 require vendor/autoload.php；它此时物理文件都还没写入磁盘
如果必须用项目代码，改用 require __DIR__.'/../vendor/autoload.php' 并加存在性判断：if (!file_exists(__DIR__.'/../vendor/autoload.php')) { echo "autoload missing, skipping"; exit(0); }
更稳妥的做法：把需 autoload 的逻辑挪到 post-install-cmd 或 post-update-cmd，它们保证 autoload.php 已就绪

确认脚本退出码非零且不静默失败

Composer 只认退出码，不看 echo 或 print。脚本里只输出错误却不 exit(1)，它就当成功继续跑。

PHP 脚本中检测失败后必须显式退出：if (!$config) { echo "config.json missing\n"; exit(1); }
类方法中推荐抛异常：throw new RuntimeException('env not ready')，Composer 会自动捕获并转为错误退出
Shell 脚本同理：末尾别漏 exit 1，尤其用了 set -e 时要注意命令链中断是否被覆盖
避免只写 echo "error" + 没后续动作——这是最常被忽略的“假失败”

排查路径、权限与递归调用陷阱

pre 钩子常被用来做环境校验或清理，但一不小心就会踩进路径错乱、权限不足或自己调自己（composer install 套娃）的坑。

脚本内别用相对路径如 ./scripts/check-env.php；当前工作目录虽通常是项目根，但某些 CI 或 IDE 会覆盖它，统一用 __DIR__ 定位
Linux/macOS 下，若 pre 脚本是 shell 文件（如 bin/pre-check.sh），必须 chmod +x bin/pre-check.sh；Windows 用户请显式写 "php bin/pre-check.php"，别依赖 shebang
绝对禁止在 pre-install-cmd 里调 composer install 或 composer update——锁文件正被父进程占用，必卡死或报 failed to open stream: composer.lock
Docker/CI 场景下，检查 vendor/ 和 composer.lock 所属用户是否与容器内 UID 一致；不一致时即使加了 +x，execve() 也会拒绝执行