Jenkins运行jfrog命令报403 Forbidden错误但全局配置测试连接正常

问题排查步骤 #

• 凭证与认证方式校验
  先确认Jenkins全局配置中测试连接使用的账号、认证凭证，和Job执行命令中--user、--password参数的取值完全一致。多数情况下Jenkins全局Artifactory配置默认使用API密钥而非账号密码做认证，如果你的Artifactory实例开启了「禁止密码访问API」的全局开关，直接传递账号密码调用接口必然返回403，可将命令中--password=****替换为--apikey=你的Artifactory API密钥重试。
• 运行节点网络校验
  Jenkins全局配置的连接测试由Jenkins主节点发起请求，若当前Job运行在独立的Agent节点上，需检查两个配置：
  1. Agent节点的IP是否已加入Artifactory的访问白名单
  2. Agent节点是否配置了HTTP/HTTPS代理，确认代理有权限访问Artifactory，且不会丢弃请求中的认证头
• 账号权限校验
  确认命令中使用的账号拥有Artifactory的基础访问权限，且账号的个人设置中已开启「允许使用密码/API密钥调用接口」的权限，未被管理员限制API访问能力。
• 命令与变量校验
  在jfrog命令后添加-v参数输出完整请求日志，确认认证头、请求地址是否和全局配置一致。如果命令中的****是Jenkins凭证变量，可登录到Job运行的Agent节点手动执行相同命令复现，排查是否存在变量未被正确替换、把变量名作为字面量传递的问题。

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