Yarn执行升级时出现‘no candidates found’错误的原因解析

错误含义 #

YN0082是Yarn 4.x在依赖解析阶段抛出的错误，核心意思是Yarn无法找到满足当前依赖约束的包版本候选——哪怕你在npmjs上能看到对应版本，Yarn本地或其配置的源里找不到匹配的版本。

常见触发原因 #

• 源配置问题：Yarn使用的npm源（比如私有源、镜像源）没有同步到最新的包版本，或者部分包在该源中缺失。比如你用的镜像源滞后于npmjs官方，导致Yarn找不到已在官方上线的版本。
• 依赖约束冲突：当前项目的其他依赖可能对目标包设置了更严格的版本限制，和你要升级的版本产生冲突，Yarn无法找到同时满足所有约束的版本。比如netlify-cli 17.8.1要求@netlify/zip-it-and-ship-it@9.28.1，但项目里另一个依赖要求该包必须低于9.28.0，就会导致无候选版本。
• Yarn缓存过期：Yarn本地缓存的包元数据过时，无法识别新发布的版本。这种情况下Yarn会认为该版本不存在。
• 包的版本标签或发布状态异常：有些包虽然在npmjs上显示存在，但可能是发布后又撤回（unpublish），或者版本标签存在问题，导致Yarn的解析逻辑无法识别。
• 工作区配置问题：如果是monorepo项目，工作区的依赖范围配置可能限制了包版本的选择，导致Yarn无法跨工作区找到合适的版本。

快速排查方向 #

1. 检查Yarn的源配置：运行yarn config get registry确认使用的源，尝试切换到官方源后重新执行升级。
2. 清理Yarn缓存：执行yarn cache clean清除本地缓存，再重新尝试操作。
3. 检查依赖冲突：用yarn why @netlify/zip-it-and-ship-it查看该包的依赖树，确认是否有其他依赖限制了版本范围。
4. 验证包的实际发布状态：用npm view @netlify/zip-it-and-ship-it versions命令确认官方源中是否真的存在目标版本，避免npmjs页面缓存导致的视觉误差。

内容的提问来源于stack exchange，提问作者Marian Klühspies