答案是IP被限或镜像配置错误，需先用composer config -g repo.packagist.org验证源配置，切回官方源测试，再切换阿里云/腾讯云合规镜像并清缓存；私有包须置顶repositories、设vcs类型、配auth.json认证。
Composer install 报错 Could not fetch https://repo.packagist.org 或 Package not found on packagist.org
这不是网络连不上那么简单，而是 Packagist 官方源对某些国家/地区的 IP 做了访问限制，或你本地配置了被屏蔽的镜像源。国内常见表现是卡在 Downloading https://repo.packagist.org/packages.json，最终超时或返回 403/404。
实操建议：
- 先运行
composer config -g repo.packagist.org查看当前全局源配置，确认是否误设为已停用的旧镜像（如https://packagist.phpcomposer.com） - 临时切回官方源验证：执行
composer config -g repo.packagist.org https://repo.packagist.org，再composer clear-cache，重试composer install - 若官方源仍失败，说明是 IP 被限——此时不能硬刷，需切换合规镜像
使用阿里云、腾讯云等国内 Composer 镜像源
阿里云和腾讯云镜像目前稳定可用，且同步频率高（通常 5 分钟内更新），但注意它们不代理所有私有包或含 license 限制的商业包（如某些 Laravel Nova、Statamic 插件）。
实操建议：
- 全局切换阿里源：
composer config -g repo.packagist.org https://mirrors.aliyun.com/composer/ - 仅当前项目切换（推荐）：
composer config repo.packagist.org https://mirrors.cloud.tencent.com/composer/ - 切完务必执行
composer clear-cache，否则旧缓存可能继续触发错误 - 如果项目
composer.json中显式写了"repositories"数组，优先级高于全局配置，需手动删或改其中的packagist.org条目
遇到 Could not parse version constraint 或 license restriction 类报错
这类错误不是网络问题，而是 Composer 在解析依赖时发现某个包声明了严格 license（如 "license": "proprietary"），而你的 config.platform 或本地 composer.json 没有显式允许该 license 类型。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 检查报错中提到的具体包名，比如
acme/private-bundle，然后运行composer show acme/private-bundle看其 license 字段 - 若确认可接受该 license，在项目根目录
composer.json的"config"下添加："secure-http": false,<br>"platform": {"php": "8.1.0"}并补充"accept-invalid-licenses": true（仅限开发环境） - 更安全的做法是：联系包作者获取合法授权，或 fork 后修改 license 字段并发布到私有仓库，再通过
"repositories"引入
私有包 + license 限制 + 国内镜像共存时的典型坑
国内镜像默认只同步公开、MIT/Apache 等宽松 license 的包。一旦你在 repositories 里加了私有 Git 地址，又没配好认证，Composer 会先去镜像站查——查不到就报 Package not found，而不是直接走 Git。
关键点：
- 私有包必须放在
repositories列表靠前位置，且类型明确设为"vcs"或"package" - 确保
auth.json在项目根目录或COMPOSER_HOME下，内容包含对应 Git 域的 token 或密码 - 运行
composer install -vvv可看到真实请求路径——如果日志里出现mirrors.aliyun.com就说明还在走镜像，没 fallback 到私有源
复杂点在于：镜像策略、license 白名单、私有源认证三者叠加时，错误信息往往指向最表层（比如“包不存在”），实际根源却在认证失败或 license 拒绝。调试时别只盯着第一行报错。
