Composer未更新私有包，主因是未在repositories中显式声明私有源或其packages.json缺失新版本元数据；需验证源可访问、Satis已重建并推送、客户端强制刷新元数据。
依赖包无法更新，不是缓存没清干净，也不是网络断了，大概率是 Composer 根本没去你期望的源查数据，或者查了但源里压根没有那个版本的元数据。
为什么 composer update vendor/package 没反应
这个命令看似简单，但失效原因很具体：
- 目标包没出现在当前项目的
composer.json的require或require-dev字段里——Composer 不会更新“间接依赖”，哪怕它在vendor/里已存在 - 包名写错，比如漏掉
/package-name，只写了vendor，结果触发全量更新（composer update无参数行为） - 私有包没在
repositories中显式声明类型为"type": "composer"，而是误写成"type": "git"，导致 Composer 忽略该源 - 执行时加了引号（如
composer update "monolog/monolog"），shell 吞掉引号后实际运行的是composer update，又变全量
私有仓库新版本不生效的验证路径
别靠 composer update 猜，直接验证元数据是否就位：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
curl -s https://packages.example.org/packages.json | grep -A5 'vendor/package'检查新version字段是否存在 - 如果搜不到，说明 Satis 或 Private Packagist 没重建成功；检查构建日志里有没有列出对应 tag 或 commit
- 确认 Satis 配置中
"require-all": true是否启用——它默认只收录带 tag 的版本，不收dev-main分支，除非显式写"require": {"vendor/package": "dev-main"} - 客户端强制刷新：先
composer config --unset repos.private，再composer config repositories.private composer https://packages.example.org，绕过缓存干扰
更新后其他包也变了，这正常吗
正常，而且不能关掉。这是依赖求解的必然结果：
-
monolog/monolog:^3.0明确 require"symfony/console": "^6.2"，而你composer.lock里是6.1.0，那symfony/console就必须升 - 想预判影响范围：先跑
composer show monolog/monolog看它的require列表；或加--dry-run：composer update monolog/monolog --dry-run - 更新完立刻看
git diff composer.lock，重点确认：packages下该包的version、dist是否变化；packages-dev区块是否被连带改动（常见于 dev-only 包）
锁文件冲突或解析失败时的底线操作
当 Your requirements could not be resolved 反复出现，别硬调约束：
- 先删干净：
rm -rf vendor composer.lock，再composer install -v—— 这是排除历史状态污染的唯一可靠起点 - 如果问题依旧，运行
composer diagnose，它会暴露 CA 证书、DNS 解析、minimum-stability 配置等底层问题 - 私有源不可达？临时切回 Packagist 测试：
composer config --unset repos.packagist，再composer config repos.packagist composer https://packagist.org - CI 环境下优先用
composer update --no-cache，避免本地缓存掩盖源端问题
最常被忽略的点：Composer 不会自动感知私有源的变更，它只信任自己缓存的 packages.json 内容。哪怕你重建了 Satis，客户端不重载元数据，就永远看不到新版本。
