报错关键词直接决定排查方向：如“Your requirements could not be resolved”属依赖冲突，需用composer why-not定位；“Permission denied”是权限问题，须修复属主；“Checksum mismatch”需删vendor和composer.lock重装，“Content-Length mismatch”则先清缓存换镜像；“Connection refused”表明请求未发出，应查网络或代理。
报错关键词直接决定排查方向
看到报错第一眼别急着清缓存或重装，先盯住错误里最短、最具体的那串词——它直接对应故障层级。比如Your requirements could not be resolved是依赖求解失败，Permission denied是文件系统权限问题，Connection refused说明请求根本没发出去，Checksum mismatch和Content-Length mismatch看着像一类，但修复动作完全相反。
这些不是模糊提示，而是 Composer 内部抛出的明确断点信号。忽略关键词硬套“清缓存+换镜像”模板，90% 会反复踩坑。
用 composer diagnose 和 check-platform-reqs 定位真问题
composer diagnose只验证 Composer 自身运行环境（如 json、mbstring 扩展），不检查你项目实际需要的扩展。真正暴露缺口的是composer check-platform-reqs——它读composer.json里的ext-gd、php:8.2等声明，逐条比对当前 PHP CLI 环境是否满足。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
php --ini确认 CLI 加载的是哪个php.ini，别改错文件（Web 和 CLI 的配置常不一致） - 用
php -m | grep -E 'curl|openssl|mbstring|zip'筛出缺失扩展，Windows 用户可用php -m后肉眼扫 - 扩展名存在 ≠ 可用：运行
php -r "print_r(gd_info());"验证 GD 是否真能工作
镜像配置是否生效？别信 config 输出，要看真实请求
composer config -g repo.packagist输出正常，不代表镜像在用。Composer 2.x 静默 fallback 到官方源时，不报错也不提醒。真正验证方式是：
- 运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址 - 如果 URL 是
https://packagist.org/而非你配的阿里云地址，说明镜像没走通 - 常见原因：项目级
composer.json里有空"repositories": []字段，它会彻底屏蔽全局镜像 - 临时清掉项目级配置：
composer config --unset repositories（注意没-g）
卡在 Resolving dependencies 超过 30 秒？大概率是循环依赖
这不是网络慢，是 Composer 在本地穷举版本组合时陷入逻辑死锁。现象很典型：
- CPU 拉满、无网络请求、日志停在
Resolving dependencies... - 错误里出现
Package a depends on b, which depends on a这类闭环描述 - 运行
composer depends myorg/core --tree，若输出中myorg/core出现两次（如myorg/core ← myorg/api ← myorg/core），就是闭环链路 - 重点查
require-dev包的autoload路径——比如phpunit/phpunit把你的src/加进它的加载路径，而你又继承它的类，就形成隐式循环
没有跳过或强制安装选项，唯一解法是抽离共用接口到独立契约包，或注释掉require-dev逐个验证。删vendor和composer.lock也救不了，因为问题在依赖图结构本身。
