“your requirements could not be resolved”是依赖冲突或环境不满足，需用composer why-not检查版本锁死、核对php -v与require.php字段、排查composer.json中硬编码版本及cli真实扩展。
报错直接看关键词，别猜——Your requirements could not be resolved 是依赖冲突或环境不满足，file could not be downloaded 是网络或镜像问题，Permission denied 几乎全是属主错配，command not found 就是 PATH 或 PHP CLI 没到位。
“Your requirements could not be resolved” 怎么快速定位拦路虎
这个错误不是网络慢，也不是包不存在，而是 Composer 已经读完所有元数据，但在本地求解时找不到满足全部约束的版本组合。
- 先跑
composer why-not php:8.3（把 8.3 换成你目标 PHP 版本），它会直接告诉你哪个包锁死了旧版 PHP - 打开
composer.lock，找任意一个包的require.php字段，比如"php": "^8.1"，再运行php -v看是否 ≥ 8.1 - 检查
composer.json里有没有写死版本号，例如"monolog/monolog": "2.9.0"，而新引入的包要求^3.0，两者无交集 - 别信
phpinfo()页面——Web 和 CLI 可能加载不同php.ini，必须用php -m | grep -E "mbstring|openssl|curl|xml|dom"验证扩展真实可用
“file could not be downloaded” 或卡在 “Loading composer repositories”
国内用户遇到这类问题，90% 是直连 Packagist 失败，不是你本地环境坏了。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 立刻切阿里云镜像：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/（注意：是repos.packagist，不是repo.packagist） - 切完必须清缓存：
composer clear-cache，否则失败记录还在，重试照样卡住 - 验证是否生效：
composer config -g repos.packagist输出必须是完整 JSON，含"type": "composer"和末尾带斜杠的 URL - 如果项目根目录
composer.json里有"repositories"字段（哪怕空数组），全局镜像就失效，得进项目目录执行composer config repos.packagist composer https://mirrors.aliyun.com/composer/
“Permission denied” 报 vendor/autoload.php 或 composer.lock
95% 的情况不是权限位不够，而是 vendor/、composer.lock 或 ~/.composer 被 sudo composer install 污染成了 root 所有。
- 查归属：
ls -ld vendor/，若第三列不是当前用户名（$(whoami)），就是它了 - 别用
chmod -R 777 vendor/——这会让vendor/bin/phpunit这类可执行文件被 CI 工具拒绝，Git 也会报 ownership changed - 修复命令：
sudo chown -R $USER:$USER vendor/ composer.lock（注意末尾没斜杠，否则漏掉文件） - 全局缓存也要查：
ls -ld $(composer config --global cache-dir)，错配就同步修复：sudo chown -R $USER:$USER $(composer config --global cache-dir)
Docker / CI 环境里反复 Permission denied
本质是 UID 不一致：宿主机用户 UID 是 1001，容器默认用 0（root）或另一个 UID，挂载卷后文件不可写。
- 不要在容器里跑
sudo composer install，改用匹配 UID 启动：docker run -u $(id -u):$(id -g) - CI 脚本中加清理步骤：
rm -rf vendor/ composer.lock && composer install，或强制修复：sudo chown -R $USER:$USER vendor/ - 构建镜像时显式设归属：
RUN chown -R www-data:www-data /app（按你实际 Web 用户名调整） - 最易被忽略的一点：所有修复都必须在删掉污染产物（
vendor/、composer.lock、~/.composer）之后再执行，否则修了也白修
