答案是先验证包是否存在再排查镜像与配置。打开https://packagist.org/packages/vendor/package确认包名及版本是否正确；检查composer config -g repo.packagist输出是否为带末尾/的有效url；私有包需确保repositories中type声明正确且排在镜像前；清除缓存、删除vendor和composer.lock后重装。
Composer 报 404 不是网络连不上，而是它真没在当前配置的源里找到那个包——要么包名/版本写错，要么镜像没同步，要么私有包漏配了 type。
看到 404 Not Found 先别换镜像，打开 Packagist 确认包是否存在
绝大多数 404 根源是包本身不存在于你写的路径中。Composer 不做模糊匹配，大小写、拼写、版本号全要严丝合缝。
- 把
vendor/package替换成实际值，访问https://packagist.org/packages/vendor/package—— 如果页面 404，说明包名就错了，比如guzzle/guzzle（旧名）应为guzzlehttp/guzzle - 能打开就点 “Versions” 标签，确认你要的版本（如
^7.9或dev-main）是否列在其中；dev-master很多项目已停用 - IDE 补全可能缓存废弃包名，别信自动提示，手动核对官网页面
composer config -g repo.packagist 必须返回带末尾 / 的有效 URL
镜像配置写错或失效，是国内用户最常踩的坑。很多报错表面是“找不到包”，实际是请求发到了一个已下线或格式错误的地址。
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 repo.packagist，输出应类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}—— 注意末尾必须有/，https://mirrors.aliyun.com/composer❌ 会 404 - 已停用的旧镜像（如
packagist.phpcomposer.com、packagist.laravel-china.org）自 2023 年起持续返回 404，必须立刻换掉 - 手动测通：运行
curl -I https://mirrors.aliyun.com/composer/packages.json，秒回HTTP/2 200才算活；超时或 404 说明镜像不可用或被拦截
私有包或自定义 repositories 配置错位，直接 fallback 到镜像找包
如果你 require 的是公司内部包、GitHub 私有库或 Satis 源，但 composer.json 里没写对 type 或顺序放错，Composer 就会跳过你的源，转头去镜像里瞎找——自然 404。
- Git 包必须明确写
"type": "git"，且url是可 clone 的地址，例如"https://github.com/your-org/your-package.git" - 私有 Packagist 类型源（如 Satis、Private Packagist）必须写
"type": "composer"，并确保该服务本身可访问、且已包含目标包 - 私有源必须放在镜像前面：
repositories数组中，你的私有源要排在"packagist.org"配置之前，否则 Composer 先查镜像，查不到就直接 404 - 运行
composer config --list | grep repositories确认配置已生效；项目级配置（无-g）优先于全局
composer.lock 里锁的是原始下载地址，删 vendor 不解决根本问题
很多人清了 vendor 和缓存还 404，是因为 composer.lock 里存着旧的 provider 地址（比如已失效的 GitHub API URL），composer install 会照着 lock 文件硬拉，根本不走新镜像。
- 遇到反复 404，先删掉
composer.lock和vendor/，再跑composer install（不是update）——update可能复用 lock 里的错误元数据 -
composer clear-cache必须执行，缓存里可能存着已下线镜像的 provider JSON 路径，改了配置也不生效 - CI 环境（GitHub Actions / GitLab CI）默认不继承本地配置，必须在 workflow 里显式执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
