Jenkins迁移后Maven项目通过Artifactory插件部署失败求助

可能原因分析 #

• Maven仓库配置有误（名称拼写错误、仓库不存在、权限不足）
• Maven部署路径与Artifactory仓库布局不匹配
• Artifactory插件的Maven部署参数配置错误
• Jenkins凭证权限不足或类型不匹配

分步解决步骤 #

1. 验证Artifactory仓库与权限 #

• 核对Pipeline中指定的Maven仓库key与Artifactory后台的仓库key完全一致（注意大小写敏感）
• 确认Jenkins使用的Artifactory凭证对应的用户拥有目标仓库的Deploy权限
• 用curl手动测试部署，排查是否为插件外的问题：

  curl -u <username>:<apikey> -X PUT "https://你的Artifactory地址/artifactory/目标仓库key/路径/到/artifact/artifact-version.jar" -T target/artifact-version.jar
  

  如果curl也返回404，说明问题出在仓库、权限或路径上，与插件无关

2. 检查Pipeline的Maven部署配置 #

• 对比Angular项目的Pipeline配置，确认Maven部署的仓库参数（releaseRepo/snapshotRepo）是否正确
• 确保pom.xml中的distributionManagement配置未与插件配置冲突，若插件已指定仓库，需确认插件配置覆盖了pom中的设置
• 检查插件部署器的配置示例，确保参数正确：

  rtMavenDeployer(
      id: "MAVEN_DEPLOYER",
      serverId: "ARTIFACTORY_SERVER", // 与Jenkins中配置的Artifactory服务器ID一致
      releaseRepo: "maven-release-local", // Artifactory中正式仓库的key
      snapshotRepo: "maven-snapshot-local" // Artifactory中快照仓库的key
  )
  

3. 定位404错误的具体路径 #

• 从错误堆栈中提取完整的部署请求URL（如PUT https://xxx/artifactory/xxx/xxx.jar 404）
• 在浏览器中访问该URL的父路径，确认路径是否符合Artifactory的Maven仓库布局（标准布局为groupId/artifactId/version/）
• 检查pom.xml中的groupId、artifactId、version是否正确，排除因项目坐标错误导致的路径生成异常

开启Artifactory插件的追踪日志 #

方法1：全局配置开启调试日志 #

在Jenkins系统管理 → Artifactory插件全局配置中，找到Debug Logging选项并勾选启用

方法2：Pipeline中动态设置日志级别 #

在Pipeline代码开头添加：

import org.jenkinsci.plugins.artifactory.utils.ArtifactoryLogger
ArtifactoryLogger.setLogLevel(ArtifactoryLogger.LogLevel.DEBUG)

方法3：Jenkins日志记录器配置 #

在Jenkins系统管理 → 系统日志 → 添加日志记录器，输入org.jfrog.hudson，设置日志级别为FINEST，可获取最详细的插件交互日志

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