构建Java项目Docker镜像时，如何连接Nexus下载Jar依赖？

核心问题点 #

Docker构建阶段的容器默认使用独立网络栈，容器内的localhost指向自身而非宿主机，这是导致无法访问本地Nexus的核心原因。

具体解决步骤 #

• 替换Nexus访问地址
  将自定义settings.xml中Nexus的http://localhost:8081替换为宿主机专属地址：

  • Linux/macOS/Windows：使用host.docker.internal（Docker官方提供的宿主机别名），例如http://host.docker.internal:8081/repository/your-repo-id/
  • 若上述别名无效，直接使用宿主机的局域网IP（如192.168.1.100:8081）

• 验证端口映射与网络连通性

  1. 确认Nexus容器的端口映射配置正确，如docker run -d -p 8081:8081 sonatype/nexus3，确保宿主机能通过localhost:8081正常打开Nexus页面
  2. 可在Dockerfile中临时添加测试命令，验证容器内能否访问Nexus：

     RUN curl -v http://host.docker.internal:8081
     

• 确保Maven配置匹配

  1. 检查settings.xml中的仓库ID、URL，需与pom.xml中依赖引用的仓库信息完全一致，示例配置：

     <repositories>
       <repository>
         <id>nexus-local</id>
         <url>http://host.docker.internal:8081/repository/custom-repo/</url>
         <releases><enabled>true</enabled></releases>
         <snapshots><enabled>false</enabled></snapshots>
       </repository>
     </repositories>
     

  2. 确认Dockerfile中正确复制并使用自定义settings.xml：

     COPY settings.xml /root/.m2/settings.xml
     RUN mvn clean package -DskipTests
     

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