Nexus配置指南：Java环境与内网仓库设置

本文深入剖析了 Nexus 私服搭建与运维中最棘手的几类真实问题：从服务启动即退出（根源在于 nexus 用户对 nexus-data 目录权限不足及 JVM 路径未显式配置）到 Maven 无法正确命中内网仓库（常因 settings.xml 位置错误、镜像配置失效或匿名访问被禁），再到部署失败的 401 错误（实则涉及凭证加密、仓库策略、角色权限三重校验），层层拆解权限链、配置作用域与策略耦合的隐性陷阱——告诉你为什么“看似配对了却不起作用”，并给出可立即落地的修复命令、安全加密方案和关键验证步骤，助你避开那些日志不报错、现象难复现、排查耗半天的典型坑。

为什么 nexus.service 启动后立刻退出？

常见现象是执行 systemctl start nexus 看似成功，但马上变成 inactive (dead)。根本原因不是 Nexus 本身挂了，而是它默认以非 root 用户（nexus）运行，而该用户没有对 ./nexus-data 目录的读写权限，或者 JVM 路径没配对。

• 检查日志：直接看 ./nexus-data/log/nexus.log，开头几行通常就写着 Permission denied 或 Unable to access jarfile
• 修复权限：用 root 执行 chown -R nexus:nexus ./nexus-data 和 chown -R nexus:nexus ./nexus
• JVM 必须显式指定：在 ./bin/nexus.rc 里取消注释 export INSTALL4J_JAVA_HOME_OVERRIDE=，填上 /usr/lib/jvm/java-17-openjdk-amd64 这类真实路径（别用 java -version 输出的模糊描述）

Java 项目连不上内网 Nexus 的 http://nexus.internal:8081？

不是网络不通，大概率是 Maven 没走对仓库地址，或认证卡在元数据拉取阶段。Nexus 默认关闭匿名访问时，连 maven-metadata.xml 都会 401，但错误信息往往藏在 mvn clean compile -X 的输出末尾。

• settings.xml 里必须同时配 （含账号密码）和 （把所有中央仓库请求重定向到 Nexus）
• 密码不能明文写进 XML —— 用 mvn --encrypt-password xxx 加密后填进 标签
• 如果 Nexus 开启了 HTTPS 但证书是自签的，Java 会拒绝连接；临时解决：在 MAVEN_OPTS 加 -Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true（仅限内网测试）

mvn deploy 报错 Return code is: 401, ReasonPhrase: Unauthorized

这个错误表面是认证失败，但实际可能发生在两个环节：一是上传构件时没带凭证，二是 Nexus 的仓库策略不允许部署（比如把 maven-releases 设成了只读）。重点看 Nexus 后台的仓库配置页里 “Deployment Policy” 是不是 Allow Redeploy 或 Disable Redeploy。

• 确认 pom.xml 中 的 URL 和 settings.xml 里 的 id 完全一致
• Release 构件必须打 tag 后部署，快照（-SNAPSHOT）才允许覆盖；如果误把快照版发到 release 仓库，Nexus 会静默拒绝
• Nexus 3.40+ 默认禁用匿名部署，即使你配了 server，也要确保 Nexus 用户有 nx-repository-view-*-*-edit 角色

为什么 mvn dependency:tree 显示依赖来自 central 而不是你的 Nexus？

说明 Maven 根本没走镜像配置。最常踩的坑是 settings.xml 放错了位置：它必须在 ~/.m2/settings.xml（用户级），而不是项目根目录下，也不是 $M2_HOME/conf/settings.xml（全局级，会被用户级覆盖）。

• 验证镜像是否生效：运行 mvn help:effective-settings，搜 块，确认 * 或 central 存在且 是你的 Nexus 地址
• 不要在 pom.xml 里再写 —— 这会绕过镜像，直接连原始仓库
• 公司级统一配置建议用 settings-security.xml + 加密密码，避免每个开发者手动改 settings.xml

Nexus 的麻烦点不在安装，而在权限链和 Maven 配置的耦合性——一个地方没对齐，整个链路就断在你看不见的地方。特别是 settings.xml 的作用域、Nexus 用户角色、仓库 Deployment Policy 这三者，得一块儿调，单改一个没用。

今天关于《Nexus配置指南：Java环境与内网仓库设置》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！