Composer报Fatal error并非自身崩溃，而是其加载的代码、扩展缺失、内存不足或autoload映射错误等PHP层面问题所致，应查php.ini配置和PHP错误日志，而非重装Composer。
报错“Fatal error”不是 Composer 崩了，是 PHP 层面出问题
Composer 本身不抛 Fatal error，它只是个 PHP 脚本执行器。真正触发 Fatal error 的，永远是它加载的代码、扩展缺失、内存不足或 autoload 映射错误——查 php.ini 和 PHP 错误日志，别重装 Composer。
常见假象包括：
-
pcntl_signal(): pcntl extension is not loaded：不是 Composer 错，是 symfony/console v6.2+ 在 CLI 初始化时调用失败，被 Composer 错误处理器转成 fatal；解法是启用pcntl扩展，或临时加环境变量SF_SKIP_SIGNAL_HANDLER=1 -
Fatal error: Class 'XXX' not found却有文件：大概率是入口没require vendor/autoload.php，或composer.json里 PSR-4 前缀写错（比如漏了末尾），或路径实际不存在 - 离线环境执行
composer install后类找不到：autoload 映射根本没生成，手动跑composer dump-autoload --optimize补上
中文镜像下“file could not be downloaded”怎么快速验证是不是镜像问题
国内用户看到这个错，90% 不是网络不通，而是证书、镜像延迟或 HTTPS 校验失败。
三步定位：
- 确认 CA 证书路径有效：
php -i | grep cafile，若为空或路径不可读，手动在php.ini加openssl.cafile=/etc/ssl/certs/ca-certificates.crt（Linux）或对应 Windows 路径 - 立刻切阿里云镜像并清缓存：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，再composer clear-cache - 临时关 HTTPS 校验仅用于排查：
composer config -g secure-http false；成功后再开回来，避免长期禁用
内存耗尽报 Fatal error: Out of memory，php -d memory_limit=-1 还不行？
关键不是参数没生效，而是你没用对 PHP 可执行文件，或被系统级限制卡住。
必须检查：
- 运行
which php（Linux/macOS）或where php（Windows），确认php -d memory_limit=-1 composer.phar update调用的是 CLI 版 PHP，不是 Apache 或 FPM 模块 - 别用
composer别名——它可能是 shell alias 或 wrapper，会绕过-d参数；直接用php -d memory_limit=-1 /path/to/composer.phar update - Docker 或 CI 环境下，
php -d memory_limit可能被 cgroup 内存配额拦截；得同步调高容器内存 limit，光改 PHP 配置无效 - 如果只在
dump-autoload -o阶段爆内存，说明项目类太多或 PSR-4 映射太宽（如"App\": "src/"覆盖了不该扫的目录），先去掉-o试试
Your requirements could not be resolved 是依赖冲突，跟镜像无关
这个错说明 Composer 已经从镜像拿到全部元数据，但在本地求解时找不到满足所有约束的版本组合——镜像换再快也没用。
精准定位步骤：
- 查谁硬拦你装某个包：
composer prohibits vendor/package:version（例如laravel/framework:11.0被spatie/laravel-backup的"conflict": {"laravel/framework": ">=11"}拦住） - 查哪个包锁死了低版本 PHP：
composer why-not php:8.3，常暴露老旧 bundle 或手动写死的"php": "7.4.0" - 加
--dry-run -v执行composer require，错误行里带cannot be installed because的那条就是第一个断点 -
conflict字段是硬性排斥，遇到就直接放弃，不会尝试降级；删掉或改宽松再试
PSR-4 映射撞车（比如两个包都声明 "App\": "src/"）会导致随机加载、二次声明报 Fatal error: Cannot declare class，这种冲突不会出现在依赖解析阶段，但会让后续运行直接崩——得去 composer.json 里收紧命名空间前缀，或用 exclude-from-classmap 屏蔽冲突文件（注意：对 PSR-4 无效）。
