composer install 报错通常源于镜像配置错误、缓存污染、权限问题或 php 环境不匹配；应优先根据报错关键词定位：如“connection refused”需检查 dns、镜像 url 和 ca 证书，“permission denied”需修复目录属主，“your requirements could not be resolved”需分析依赖冲突，中断后可尝试 --dry-run 续装。
服务器部署时 composer install 报错，八成不是 Composer 坏了，而是镜像没配对、缓存污染、权限错位或 PHP 环境不匹配——直接看报错关键词，比重装快十倍。
报 “Connection refused” 或 “Could not resolve host” 怎么办
这是系统级连通失败，和 Composer 本身无关。DNS 解析失败、镜像 URL 少斜杠、CA 证书过期都会触发这类错误。
- 先验证 DNS：运行
ping packagist.org，如果返回unknown host，说明解析失败；但别急着改系统 DNS，优先走 Composer 镜像 - 确认镜像是否真生效：运行
composer config -g repo.packagist，输出必须是完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；漏掉type、URL 缺末尾/、键名写成repos.packagist，它就静默退回原站 - 切镜像后必须清缓存：
composer clear-cache，否则旧失败记录还在，重试照样走packagist.org - 如果仍报 SSL 错误（如
unable to get local issuer certificate），不是镜像问题，是 PHP 的curl.cainfo指向了过期证书；运行php --ini找到真实加载的php.ini，设好curl.cainfo = "/path/to/cacert.pem"（推荐从 curl.se 下载最新版）
报 “Permission denied” 写 vendor/ 或 composer.lock
这不是权限不够，是目录“认错了主人”。vendor/、composer.lock 或 ~/.composer 被 sudo 污染过，属主是 root，而你正以普通用户（比如 www）运行命令。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 立刻检查归属：
ls -ld vendor/ composer.lock $(composer config --global home)；只要看到root，就是问题根源 - 修复方式是改归属，不是加权限：
sudo chown -R $USER:www-data vendor/ composer.lock（假设 Web 用户是www-data） - 特别注意宝塔环境：宝塔默认用
www用户执行命令，你在终端用root配的全局配置，www根本读不到；推荐进项目根目录，运行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），把镜像写进composer.json的repositories字段里，更可靠
报 “Your requirements could not be resolved”
这说明 Composer 已经连上镜像、拿到元数据，但在本地求解依赖时卡住了——纯约束冲突，和网络、权限完全无关。
- 别删
vendor或换镜像，先定位拦路包：composer why-not php:8.3（把8.3换成你目标版本），输出会直接告诉你哪个包锁死了低版本 - 检查
composer.json里有没有写死版本号，例如"monolog/monolog": "2.9.0"，而新包要求^3.0，两者无交集 - 确认 CLI PHP 版本真实可用：
php -v和php -m | grep -E "mbstring|openssl|curl|json"；Web 页面的phpinfo()和 CLI 可能加载不同php.ini - 临时绕过可用
composer install --ignore-platform-reqs，但它只是掩盖问题，上线前必须让代码真兼容目标环境
中断后 vendor 不完整，能续装吗
不能直接删 vendor 重来，尤其在 CI 或受限部署环境里——部分包已写入、autoload 已生成，但依赖链没走完，强行清空可能引发 class not found。
- 先跑
composer install --dry-run，如果输出大量Skipped，说明 Composer 能识别已安装部分，直接再跑一次composer install就能续上 - 如果
--dry-run报错（比如提示autoload.php缺失），说明中间态损坏较深，这时才需要清理：rm -f vendor/autoload.php && rm -rf vendor/composer/，然后composer dump-autoload，再composer install - 永远不要只删
vendor/下某几个包目录——Composer 只认composer.lock的完整快照，不会补“半截包”
最常被忽略的点是：项目级 repositories 配置会彻底屏蔽全局镜像，而宝塔/CI/Docker 里 ~/.composer 往往根本不存在或权限不对；与其反复调全局配置，不如直接写进 composer.json ——简单、可靠、不依赖用户上下文。
