groupId必须与注册域名倒写严格一致且全局唯一，否则私有仓库拒收或Central部署失败；需确保pom中distributionManagement的id与settings.xml中server的id完全匹配，并注意多模块继承和Central命名空间预申请。
mvn deploy 时组织名没生效，其实是 groupId 没配对
发布到私有仓库或 Maven Central 的时候，所谓“组织名称”在 Maven 里就是 groupId，不是单独字段，也不叫 organizationName。它必须和你实际注册的域名/命名空间严格一致（比如公司域名倒写），否则仓库会拒收或下游无法解析。
常见错误现象：mvn deploy 成功但包在 Nexus 上显示为 unknown，或下游项目加了依赖却报 Could not find artifact —— 很可能 groupId 和仓库中已存在的命名空间不匹配。
-
groupId必须全局唯一，推荐用公司域名倒写（如com.example），不能用中文、下划线或纯数字开头 - 私有 Nexus/Artifactory 要求
groupId匹配其配置的“Repository Layout”或“Deployment Policy”，比如只允许com.mycompany.* - 如果用
mvn release:prepare，groupId还会参与版本号生成逻辑，改错会导致 tag 名异常
settings.xml 里的 server.id 和 pom.xml 的 distributionManagement 必须能串起来
光写对 groupId 不够，Maven 得知道“把这组构件发到哪儿、用谁的身份发”。这个链路由两头组成：pom 里声明目标仓库地址和 ID，settings.xml 里提供对应 ID 的账号密码。
典型断链表现：报错 Authentication failed for https://nexus.example.com/repository/maven-releases/，但账号明明是对的 —— 很大概率是 server.id 和 repository.id 对不上。
- pom.xml 中
<distributionmanagement></distributionmanagement>下的<id></id>（比如nexus-releases）必须和~/.m2/settings.xml里<server></server>的<id></id>完全一致（区分大小写） -
<url></url>值要带完整路径，比如https://nexus.example.com/repository/maven-releases/，结尾斜杠不能少，否则部分 Nexus 版本会 405 - 如果用 token 认证（如 Nexus 3 API key），填在
<password></password>里，<username></username>填admin或对应用户，别留空
多模块项目里，子模块的 groupId 默认继承父 POM，但容易被手动覆盖
父子模块结构下，子模块如果不显式声明 groupId，会自动继承父 POM 的值。但很多人复制粘贴时手抖加了一行 <groupid>com.xxx</groupid>，结果和父 POM 不一致，导致 deploy 后坐标分裂 —— 父模块发到 com.parent，子模块跑到 com.xxx，下游引用直接失效。
查这个问题最快的方法：运行 mvn help:effective-pom -pl submodule-name，看输出里实际生效的 groupId 是什么。
- 子模块应删掉显式的
groupId、version（除非真要独立版本），靠<parent></parent>继承 - 父 POM 的
packaging必须是pom，否则子模块继承机制不触发 - IDE（如 IntelliJ）有时会缓存旧 effective-pom，改完记得刷新 Maven project，别只信编辑器左下角显示
发布到 Maven Central 需额外校验 groupId 是否已注册
Central 不接受任意 groupId，必须提前在 Sonatype JIRA 提交工单申请命名空间，批准后才能用。直接 deploy 会卡在 gpg: signing failed: Inappropriate ioctl for device 或更隐蔽的 Return code is: 400, ReasonPhrase: Bad Request. —— 后者往往就是 groupId 未授权。
- 申请时填的
groupId（比如io.github.username）必须和 pom.xml 里完全一致，包括大小写和点号位置 - 验证方式：访问
https://search.maven.org/artifact/{groupId}/{artifactId}，如果返回 404 且你确定没发过，说明还没通过审批 - 同步到 Central 是异步的，deploy 到 OSSRH 后还要等几小时，期间
mvn clean deploy可以重试，但别反复提交工单
真正麻烦的不是配错标签，而是 groupId 一旦对外公开使用，就几乎没法改 —— 所有下游依赖、文档、CI 脚本全得跟着动。定之前最好在团队内确认好归属和生命周期。
