从Artifactory下载Npm依赖报错403问题排查求助
排查步骤
1. 验证工作目录写入权限猜想
你猜测的目录权限问题是高概率诱因,可先通过以下方式验证:
- 在Jenkins任务的
rtnpminstall执行步骤前,新增一段Shell执行逻辑:
# 输出当前执行用户、工作目录路径、目录权限信息 whoami pwd ls -la ./ # 测试当前目录写入权限 mkdir test_write_check && echo "权限正常" && rmdir test_write_check
如果上述mkdir步骤执行失败,说明确实是Jenkins运行用户没有工作目录的写入权限,执行以下命令修复即可:chown -R jenkins:jenkins <你的Jenkins工作目录对应路径>
如果目录权限正常,继续排查后续项。
2. 排查Artifactory插件的权限配置差异
你直接访问链接、全局安装都能成功,说明你的个人账号有资源访问权限,但Jenkins调用Artifactory插件用的是独立配置的服务账号,可能存在权限限制:
- 检查Jenkins全局配置中,绑定的Artifactory凭证对应的账号,是否拥有对应npm仓库的本地缓存写入权限:
rtnpminstall默认会把下载的依赖同步缓存到工作目录的.npm子目录,同时会上报缓存信息到Artifactory服务端,部分安全策略会禁止服务账号写入缓存区,但全局安装走的是你本地的个人凭证,不受该限制 - 可以临时给
rtnpminstall加上--no-sync参数,跳过缓存同步步骤,测试是否能正常执行
3. 排查npm配置差异
- 在Jenkins任务中分别执行
npm config list(项目级配置)和npm config list -g(全局配置),对比两者的registry地址、认证token配置是否一致 - 检查项目根目录是否存在
.npmrc文件,文件内配置的Artifactory认证信息是否过期,如果本地的项目级认证信息无效,会触发403报错,而全局配置的认证信息有效所以全局安装正常
4. 排查安全策略规则
- 检查Artifactory关联的Xray安全拦截策略,是否存在针对工作目录路径、项目标识的依赖版本拦截规则,部分企业会设置项目级的依赖白名单,仅拦截对应项目的安装请求,不影响全局安装
- 你可以在Jenkins任务的工作目录下手动执行普通npm安装命令测试:
npm install --registry https://<artifactoryurl>/artifactory/api/npm/<npm registry>/
如果手动执行也报403,说明是项目级的安全策略限制,如果执行正常,说明是Artifactory插件的rtnpminstall命令本身的参数配置问题,可重装或升级Artifactory插件解决。
内容的提问来源于stack exchange,提问作者Devops
相关产品推荐
相关产品推荐

