使用Ant Maven Resolver上传Nexus时出现metadata不匹配错误

问题描述 #

尝试使用Ant将文件上传至Maven（Nexus）仓库，执行ant deploy时报错。以下是相关配置文件及错误日志：

build.xml #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:resolver="antlib:org.apache.maven.resolver.ant">

   <path id="maven-ant-tasks.classpath" path="path/to/lib/maven-ant-tasks-2.1.3.jar" />
   
   <typedef resource="org/apache/maven/artifact/ant/antlib.xml" uri="antlib:org.apache.maven.artifact.ant" classpathref="maven-ant-tasks.classpath" />

   <taskdef uri="antlib:org.apache.maven.resolver.ant" resource="org/apache/maven/resolver/ant/antlib.xml">
      <classpath>
         <fileset dir="path/to/lib/" includes="maven-resolver-ant-tasks-1.4.0-uber.jar"/>
      </classpath>
   </taskdef>

   <property name="nexus_web" value="https://nexus.location.com/repository/location/item" />

   <resolver:authentication username="login-username" password="PASSWORD" id="auth"/>

   <resolver:remoterepo id="server" url="${nexus_web}">
      <resolver:releases enabled="true" checksums="warn"/>
      <resolver:authentication refid="auth"/>
   </resolver:remoterepo>

   <resolver:remoterepos id="all">
      <resolver:remoterepo refid="server"/>
   </resolver:remoterepos>

   <resolver:artifacts id="producedArtifacts">
      <resolver:artifact file="path/to/item/build/item/build/item-21-08-8.tar"/>
   </resolver:artifacts>

   <resolver:pom file="nexus-upload-pom.xml" id="pom"/>

   <target name="deploy">
      <resolver:deploy artifactsref="producedArtifacts">
         <resolver:remoterepo refid="server"/>
      </resolver:deploy>
   </target>
</project>

nexus-upload-pom.xml #

<project>
   <modelVersion>4.0.0</modelVersion>

   <groupId>testing</groupId>
   <artifactId>item</artifactId>
   <version>21-08-2</version>
   
   <name>item-name</name>
</project>

错误日志 #

deploy:
[resolver:deploy] Using default POM (testing:item:21-08-2)
[resolver:deploy] Uploading https://nexus.location.com/repository/testing-maven/item/testing/item/21-08-2/item-21-08-2.pom
[resolver:deploy] Uploaded https://nexus.location.com/repository/testing-maven/item/testing/item/21-08-2/item-21-08-2.pom (189 B at 0.7 KB/sec)
[resolver:deploy] Uploading https://nexus.location.com/repository/testing-maven/item/testing/item/21-08-2/item-21-08-2.tar
[resolver:deploy] Uploaded https://nexus.location.com/repository/testing-maven/item/testing/item/21-08-2/item-21-08-2.tar (347500 KB at 23231.7 KB/sec)
[resolver:deploy] Downloading https://nexus.location.com/repository/testing-maven/item/testing/item/maven-metadata.xml
[resolver:deploy] Uploading https://nexus.location.com/repository/testing-maven/item/testing/item/maven-metadata.xml

BUILD FAILED
path/to/item/build/nexus-upload.xml:34: Could not deploy artifacts: Failed to deploy metadata: Could not transfer metadata testing:item/maven-metadata.xml from/to dug (https://nexus.location.com/repository/testing-maven/item): status code: 400, reason phrase: Invalid maven-metadata.xml GAV testing, item, null does not match request path item/testing/item/maven-metadata.xml (400)

Total time: 16 seconds

服务器对应路径下无maven-metadata.xml文件，需排查上传环节问题，确认是配置错误（错误中的null值可疑）还是遗漏配置。

问题分析与解决 #

核心问题：Nexus仓库URL配置错误 #

错误日志里的路径暴露了关键问题：

• 你配置的nexus_web是https://nexus.location.com/repository/location/item
• 实际上传时生成的路径是https://nexus.location.com/repository/testing-maven/item/testing/item/...

Nexus仓库的URL必须指向仓库根地址，不能额外拼接子路径。你在URL末尾加了/item，导致Ant构建上传路径时，把groupId、artifactId重复拼接在这个额外的item后面，形成了item/testing/item的错误路径，和POM里的GAV（testing:item:21-08-2）完全不匹配，因此Nexus返回400错误，且元数据里的version字段出现null（路径结构混乱导致无法识别版本）。

修正步骤 #

1. 修正仓库URL
   去掉nexus_web末尾的/item，并替换为正确的仓库根地址（错误日志显示仓库为testing-maven）：

   <property name="nexus_web" value="https://nexus.location.com/repository/testing-maven" />
   

2. 显式关联POM到deploy任务
   当前resolver:deploy未指定pomref，虽然日志显示用了默认POM，但显式指定可避免潜在问题：

   <target name="deploy">
      <resolver:deploy artifactsref="producedArtifacts" pomref="pom">
         <resolver:remoterepo refid="server"/>
      </resolver:deploy>
   </target>
   

3. 统一文件与POM的版本号
   上传的tar包文件名是item-21-08-8.tar，但POM里的version是21-08-2，版本号不一致。这不是本次报错的直接原因，但会导致仓库中artifact与POM版本不匹配，建议统一版本号。

额外说明 #

• maven-metadata.xml由Nexus自动生成，无需手动创建，正确上传artifact和POM后，Nexus会自动维护该文件。
• 确保你的账号拥有仓库的deploy权限，虽然本次报错由路径问题导致，但权限不足也可能引发类似上传失败。

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