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。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 确认 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

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