根本原因是Composer未将自定义域名识别为私有仓库，需在composer.json中显式声明type为"composer"的repositories，并确保URL正确、auth.json配置无误、packages.json接口响应格式合规。
Composer 用自定义域名仓库时 composer install 报 404 或 401
根本原因通常是 Composer 没认出你的域名是私有仓库，直接当成 Packagist 镜像去查了。它默认只信任 packagist.org，其他域名必须显式声明为 composer repository 类型。
实操上要两步：一是在 composer.json 里加 repositories 块，二是确保包的 name 和仓库 URL 能对应上（比如 "myorg/my-package" 应该能从 https://pkg.myorg.com 的 API 返回结果中被找到）。
- 别把私有仓库配成
type: "package"—— 那是给单个静态 ZIP 用的，不支持自动发现和版本解析 - 推荐用
type: "composer"，并确保你的私有仓库实现了 Composer 的/packages.json接口（如 Satis、Private Packagist、JFrog Artifactory） - 如果用的是 Nginx/Apache，检查是否屏蔽了
.json后缀的访问，或重写了/packages.json路径
配置 repositories 时写错 url 导致依赖解析失败
常见错误是 URL 少了结尾斜杠、用了 HTTP 而不是 HTTPS（尤其当仓库强制跳转但 Composer 不跟）、或者路径拼错了——比如把 https://pkg.myorg.com/v1 写成 https://pkg.myorg.com/api/v1，而实际服务监听的是前者。
Composer 会尝试请求 {url}/packages.json，这个响应必须是合法 JSON，且包含 packages 字段。你可以用 curl -I https://pkg.myorg.com/packages.json 先验证状态码和内容类型。
- URL 必须以
/结尾（"url": "https://pkg.myorg.com/"），否则 Composer 可能拼出https://pkg.myorg.compackages.json - 不要在
url里带查询参数（如?token=xxx），认证应走auth.json - 如果仓库支持多租户（如
https://pkg.myorg.com/{vendor}/），确保composer.json中依赖的name前缀匹配该租户路径
auth.json 放错位置或格式不对，始终提示 401
Composer 只读取两个位置的 auth.json：项目根目录下的 ./auth.json（优先级高），或全局的 ~/.composer/auth.json（Linux/macOS）或 %APPDATA%\Composer\auth.json（Windows）。放错地方就等于没配。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
内容必须是标准 JSON，且 http-basic 下的域名要和仓库 URL 完全一致（包括端口、协议、大小写）——例如仓库是 https://pkg.myorg.com/，那 key 就得是 "pkg.myorg.com"，不能写成 "https://pkg.myorg.com" 或 "myorg.com"。
- 用
composer config --auth http-basic.pkg.myorg.com.username xxx命令生成最安全，避免手误 - 如果仓库用 Token 认证（如 Bearer），要用
"bearer": "xxx"字段，不是http-basic - 权限问题：确保运行
composer install的用户能读取auth.json，尤其在 CI 环境中容易因文件权限被忽略
私有包版本号写法不兼容导致 composer update 找不到匹配
私有仓库返回的 packages.json 里每个版本对象必须包含 version 字段，且格式要符合 Composer 的版本约束解析规则。常见坑是用了 Git 分支名（如 "dev-main"）但没在 composer.json 中声明 "minimum-stability": "dev"，或用了带破折号的预发布标记（如 1.0.0-beta-1）但没加引号。
另一个问题是版本号重复：多个 commit 推送了相同 version，Composer 缓存后可能拉到旧的 dist ZIP。
- 推荐用语义化版本（
1.2.3）+ Git tag，避免dev-前缀，除非你明确需要开发版 - 如果必须用分支，写成
"dev-main as 1.0.0"这种 alias 形式更可控 - 执行
composer clear-cache再update，排除本地缓存干扰
最常被跳过的其实是仓库服务本身的响应结构——哪怕 URL 和认证都对，只要 packages.json 格式不对（比如缺 packages 键、版本对象里没有 dist 或 source），Composer 就会静默跳过那个包，然后报“找不到”。建议先手动 curl 一遍完整响应体再动手写配置。
