Jenkins执行yarn install报404，本地PowerShell执行正常求助

这种情况我之前也碰到过，核心原因不是Jenkins沙箱限制了网络——毕竟你在Jenkins工作区手动开PowerShell能执行成功，说明网络是通的。问题出在Jenkins执行任务的环境和你手动操作的环境存在差异，下面一步步拆解原因和解决方案：

核心原因分析 #

• 环境变量与Yarn配置不统一：Jenkins服务默认以Local System用户运行，这个用户的环境变量、Yarn配置（比如镜像源、缓存路径）和你手动登录的用户完全不同。你在PowerShell里可能已经配置了国内镜像源（比如淘宝源），但Jenkins的环境还是用默认的yarnpkg源，导致某些旧版本包拉取失败。
• 缓存命中差异：你手动执行时，本地用户的Yarn缓存里已经有pinkie-promise@2.0.1这个包，所以不用去远程拉取；但Jenkins服务用户的缓存里没有，去默认源拉取就遇到了404。
• CMD与PowerShell的配置差异：PowerShell会加载你的用户配置文件（比如$PROFILE），里面可能包含了Yarn镜像源的设置，而CMD默认不会加载这些配置，所以CMD执行也失败，和Jenkins的情况一致。

具体解决方案 #

1. 先确认Jenkins的Yarn配置 #

在Jenkins构建任务的最前面添加一步，执行以下命令：

yarn config list
echo $env:PATH

把输出结果和你手动在PowerShell里执行同样命令的结果对比，重点看registry（镜像源）和cacheFolder（缓存路径）这两项是否一致。

2. 统一Yarn镜像源 #

如果发现Jenkins用的是默认源，而你手动用的是国内镜像源，就在Jenkins构建步骤里先设置镜像源，再执行安装：

yarn config set registry https://registry.npmmirror.com
yarn install

3. 清理缓存后重新安装 #

不管配置是否一致，都可以尝试清理Jenkins用户的Yarn缓存，强制重新拉取依赖：

yarn cache clean
yarn install --force

4. 修改Jenkins服务的运行用户 #

Windows下Jenkins默认用Local System用户，权限和环境都受限。可以尝试把Jenkins服务的运行用户改成你手动登录的用户：

• 打开「服务」找到Jenkins服务，右键选择「属性」
• 切换到「登录」选项卡，选择「此账户」，输入你的用户名和密码
• 重启Jenkins服务，这样Jenkins就会用你的用户环境执行任务，和手动操作一致

5. 替换问题依赖版本 #

如果pinkie-promise@2.0.1确实在默认源无法获取，可以检查你的package.json或yarn.lock，看看是哪个依赖间接引入了这个版本，尝试升级该依赖到最新版本，或者直接在yarn.lock里把pinkie-promise的版本替换为可用的（比如4.0.0），然后重新执行yarn install。

内容的提问来源于stack exchange，提问作者newcat