自建Nexus OSS仓库后无法解析Maven依赖求助

嗨，咱们一步步来排查这个问题——我之前也碰到过一模一样的Nexus+Maven依赖拉取失败的情况，下面是需要重点检查的几个关键点：

你部署的是1.0-SNAPSHOT版本，首先得确保：

• 你的Nexus仓库是**Maven2 (Hosted)**类型，并且仓库设置里的Version policy（版本策略）已经设为Snapshot（快照）
• 如果你的项目是匿名拉取依赖，要在Nexus的仓库权限里开启Anonymous用户的读权限；如果是认证访问，那拉取依赖的项目必须在settings.xml里配置正确的认证信息

Maven的settings.xml需要同时兼顾**部署（给Bitbucket Pipelines用）和拉取依赖（给其他项目用）**两个场景，这里给你一个标准的配置示例：

<settings>
  <!-- 部署到Nexus的认证信息，Bitbucket Pipelines里也要用这套配置 -->
  <servers>
    <server>
      <id>nexus-snapshots</id>
      <username>你的Nexus部署用户名</username>
      <password>你的Nexus部署密码</password>
    </server>
  </servers>

  <!-- 如果用Nexus作为镜像代理，要确保包含快照仓库 -->
  <mirrors>
    <mirror>
      <id>nexus-mirror</id>
      <mirrorOf>central,nexus-snapshots</mirrorOf>
      <url>http://你的Nexus地址/repository/maven-public/</url>
    </mirror>
  </mirrors>

  <profiles>
    <profile>
      <id>nexus-profile</id>
      <repositories>
        <!-- 快照仓库配置，必须开启快照支持 -->
        <repository>
          <id>nexus-snapshots</id>
          <url>http://你的Nexus地址/repository/maven-snapshots/</url>
          <releases>
            <enabled>false</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy> <!-- 强制Maven每次都检查最新快照 -->
          </snapshots>
        </repository>
        <!-- 中央仓库（如果需要的话） -->
        <repository>
          <id>central</id>
          <url>http://repo1.maven.org/maven2/</url>
        </repository>
      </repositories>
    </profile>
  </profiles>

  <!-- 激活上面的Nexus配置profile -->
  <activeProfiles>
    <activeProfile>nexus-profile</activeProfile>
  </activeProfiles>
</settings>

⚠️ 重点：<repository>里的id必须和<server>里的id完全一致，Maven是通过这个ID来关联认证信息的。

确保你在依赖项目里写的坐标完全正确：groupId、artifactId、version（必须是1.0-SNAPSHOT），一个字符都不能错！示例依赖配置：

<dependencies>
  <dependency>
    <groupId>你的项目GroupID</groupId>
    <artifactId>你的项目ArtifactID</artifactId>
    <version>1.0-SNAPSHOT</version>
  </dependency>
</dependencies>

不要只看IDEA的红色提示，先在依赖项目的根目录执行命令行验证：

mvn clean install -U

-U参数会强制Maven更新快照依赖，如果命令行能成功拉取，那就是IDEA的缓存问题，解决方法：

• 打开IDEA的File > Invalidate Caches...，选择Invalidate and Restart
• 或者右键项目，选择Maven > Reload Project

登录Nexus后台，找到你部署的快照包，确认它的存储路径符合Maven规范：
比如groupId是com.example，那路径应该是com/example/你的ArtifactID/1.0-SNAPSHOT/，里面必须有你的ArtifactID-1.0-SNAPSHOT.jar和对应的pom.xml文件。如果路径不对，大概率是部署时的项目pom.xml里的groupId/artifactId写错了。

检查你的Pipelines脚本，确保部署命令引用了正确的settings.xml，并且参数正确：

script:
  - mvn deploy -Dmaven.deploy.skip=false -s ./settings.xml

这里的settings.xml要包含正确的Nexus部署仓库ID和认证信息，和你本地用的配置保持一致。

按照上面的步骤一步步排查，基本就能定位到问题所在啦！

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