标签必须置于 根节点下的 内部，且仅顶层 中的 生效；其 必须与 pom.xml 中 的 或 的 完全一致（大小写敏感）；密码应通过 maven 主密码机制加密，而非明文存储；该配置仅影响需认证的远程操作（如 deploy），不影响 compile 等本地构建；id 与仓库 url 解耦，私服地址变更后可复用 id，但认证方式变更时需适配新机制。

settings.xml 里 <server></server> 标签写在哪才生效

必须放在 <servers></servers> 标签内部，且紧贴 <settings></settings> 根节点——不是放在 <profiles></profiles> 里，也不在 <profiles></profiles> 的 <profile></profile> 里。Maven 只认顶层 <servers></servers> 下的 <server></server>。

• 错误位置示例：<profile><servers><server>...</server></servers></profile> → 完全无效
• 正确结构是：<settings><servers><server><id>my-nexus</id>...</server></servers></settings>
• <id></id> 值必须和 pom.xml 中 <distributionmanagement></distributionmanagement> 的 <repository></repository> 或 <snapshots></snapshots> 的 <id></id> 完全一致（大小写敏感）

密码明文存 settings.xml 太危险，怎么安全加密

Maven 自带 settings-security.xml 加密机制，但不是直接加密密码，而是加密“主密码”再用它加密 server 密码。跳过这步就只能明文存，而明文在 CI/CD 或团队共享时极易泄露。

• 先生成主密码：mvn --encrypt-master-password your-master-pass，结果填入 ~/.m2/settings-security.xml 的 <master></master>
• 再加密实际密码：mvn --encrypt-password your-server-pass，把输出填到 <password></password> 字段
• 注意：加密命令必须用和构建环境相同的 Maven 版本执行，不同版本加密结果不兼容
• 如果用 Nexus/Artifactory，建议优先配 LDAP 或 token 认证，避免依赖 settings.xml 密码

<server></server> 的 <username></username> 和 <password></password> 对哪些操作起作用

只影响需要认证的远程仓库操作：部署（mvn deploy）、发布（mvn release:perform）、某些插件拉取私有依赖（如 maven-dependency-plugin 的 unpack 目标），但不影响普通 mvn compile 或本地依赖解析。

• 下载依赖走的是 <repositories></repositories> 和 <pluginrepositories></pluginrepositories>，它们靠 <id></id> 匹配 <server></server>，但仅当该仓库配置了需要认证的 URL（如 https://nexus.example.com/repository/maven-releases/）才触发认证
• mvn clean install 默认不触发任何 server 认证，除非你显式配置了 <distributionmanagement></distributionmanagement> 并执行了 deploy
• CI 环境中常漏掉 <server></server> 配置，导致 deploy 报错：401 Unauthorized 或 Failed to deploy artifacts: Could not transfer artifact ... Access denied to: ... Return code is: 401

私服地址变更后，<server></server> 的 <id></id> 还能复用吗

可以，但前提是新旧私服使用同一套用户体系、且 <id></id> 在 pom.xml 或 CI 脚本中没硬编码成其他值。真正决定是否匹配的是 <id></id> 字符串本身，不是 URL。

• 常见误区：以为改了 <url></url> 就要同步改 <id></id> —— 不需要。只要 pom.xml 里 <repository><id></id></repository> 没变，Maven 就仍会找这个 <id></id> 对应的 <server></server>
• 但如果新私服启用了不同认证方式（比如从 Basic 改为 Bearer Token），<username>/<password></password></username> 就不再适用，得换用 <configuration></configuration> 配 token，或改用 Maven 3.8.2+ 的 <authenticator></authenticator> 扩展
• 多个环境（dev/staging/prod）共用一个 <id></id> 时，容易在切换 profile 时误用错 server，建议按环境区分 <id></id>，比如 nexus-dev、nexus-prod

最容易被忽略的是：Maven 不校验 <server></server> 配置是否存在对应仓库，它只在真正发起 HTTP 请求时才报错。所以配置写错了、ID 拼错了、密码过期了，往往要等到 CI 流水线 deploy 阶段才暴露，而不是在本地验证阶段。