向Nexus部署Jar构件时出现内容类型不匹配问题

阿华AIGC实验室

2026-5-26

解决Nexus 3.1.0-04下mvn deploy快照构件失败的问题

我之前维护项目部署流程时碰到过几乎一模一样的报错，结合你的环境和错误信息，给你几个实用的排查和解决方向：

1. 先确认Nexus仓库的基础配置与权限

登录Nexus后台，找到你的snapshots仓库，检查Deployment Policy是否设置为Allow Redeploy（默认可能是Disable Redeploy，这会直接导致无法上传快照）

检查本地Maven的settings.xml里的server配置，确保用户名和密码对应Nexus中拥有nx-deploy角色（或该snapshots仓库专属deploy权限）的账号，配置示例：

<servers>
  <server>
    <id>nexus</id> <!-- 要和pom里repository的id完全一致 -->
    <username>deploy-user</username>
    <password>your-deploy-password</password>
  </server>
</servers>

直接在浏览器访问http://nexus.mydomain.io/repository/snapshots/，确认网络能正常连通，没有防火墙、代理拦截的情况

2. 解决插件兼容性问题

你当前用的nexus-staging-maven-plugin:1.5.1是比较老旧的版本，和Nexus 3.x的兼容性不太友好——这个插件原本是为Nexus 2的staging仓库流程设计的，而Nexus 3的快照仓库部署更适合用原生的maven-deploy-plugin：

方案一：替换为maven-deploy-plugin，在项目pom.xml里添加或修改：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-deploy-plugin</artifactId>
      <version>3.1.0</version>
    </plugin>
  </plugins>
</build>

方案二：如果一定要用staging插件，升级到兼容Nexus 3的新版本，比如3.2.0，修改插件版本后再尝试部署

3. 检查构件版本与本地缓存

确认项目pom.xml里的版本是0.0.1-SNAPSHOT（必须带-SNAPSHOT后缀），Maven会自动将其转换为你报错里的时间戳格式版本，不带后缀的版本无法上传到snapshots仓库
执行mvn clean deploy -U，清理本地构建产物并强制更新快照缓存，避免本地构件损坏导致的传输问题