nexus.service 启动后立刻退出的根本原因是 nexus 用户对 ./nexus-data 目录无读写权限或 jvm 路径未正确配置,需修复目录权限并显式设置 install4j_java_home_override。

为什么 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里必须同时配<server></server>(含账号密码)和<mirror></mirror>(把所有中央仓库请求重定向到 Nexus) - 密码不能明文写进 XML —— 用
mvn --encrypt-password xxx加密后填进<password></password>标签 - 如果 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中<distributionsmanagement></distributionsmanagement>的<repository></repository>URL 和settings.xml里<server></server>的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(全局级,会被用户级覆盖)。
立即学习“Java免费学习笔记(深入)”;
- 验证镜像是否生效:运行
mvn help:effective-settings,搜<mirrors></mirrors>块,确认<mirrorof>*</mirrorof>或<mirrorof>central</mirrorof>存在且<url></url>是你的 Nexus 地址 - 不要在
pom.xml里再写<repositories></repositories>—— 这会绕过镜像,直接连原始仓库 - 公司级统一配置建议用
settings-security.xml+ 加密密码,避免每个开发者手动改settings.xml
settings.xml 的作用域、Nexus 用户角色、仓库 Deployment Policy 这三者,得一块儿调,单改一个没用。







