maven私库密码必须通过settings-security.xml主密钥加密：先生成主密钥并设600权限，再加密server密码填入settings.xml；验证需检查effective-settings输出、私服权限及ci环境独立生成；生产推荐token认证或密钥管理器注入。
Java 项目中用 Maven 连私库，密码不能明文写在 settings.xml 里——这是硬性要求。Maven 原生只认一种加密路径：靠 settings-security.xml 里的主密钥解密 settings.xml 中的加密密码。它不是可选插件，而是唯一合规方案。
生成并配置 settings-security.xml（主密钥文件）
这个文件是整个加密链的“锁芯”，必须严格管控：
- 执行
mvn --encrypt-master-password your-strong-master-pass（别用简单词，也别存文本） - 把输出的 Base64 字符串（如
{VrVw6/Cg8FYHpfLj8oO/qRbMY5VrfGtIeR7RX5OHeV0=}）放进~/.m2/settings-security.xml的<master></master>标签里 - Linux/macOS 下立即执行
chmod 600 ~/.m2/settings-security.xml；Windows 用户建议用 Git Bash 或 WSL 操作，确保文件权限不被忽略 - 文件内容必须是标准 XML 格式，不能有多余空格或 BOM 头
加密 server 密码并填入 settings.xml
主密钥就位后，才能加密具体账号密码：
- 运行
mvn --encrypt-password your-real-server-password，得到类似{COQLCE6DU6GtcS5P=}的字符串 - 复制整段（含开头
{和结尾}），粘贴进settings.xml对应<server></server>的<password></password>标签内 -
<server></server>的id必须和<repository></repository>或<mirror></mirror>的id完全一致（大小写敏感、无空格） - 别手输、别删括号、别混用中文符号——少一个字符 Maven 就报
SecDispatcherException
验证是否生效 & 常见失效原因
配完不代表能用，关键看三点：
- 执行
mvn help:effective-settings，确认输出中<password></password>显示的是加密串而非明文（明文说明没走加密流程） - 检查私服后台：账号是否已分配对应仓库的
read（下载）和/或deploy（上传）权限（Nexus/Artifactory 默认不授任何权限） - CI/CD 场景下，
settings-security.xml和加密密码都必须在构建机上重新生成——跨机器无法复用，这是设计使然
生产环境更推荐的替代方式
即使加密了，把 settings-security.xml 和加密密码一起提交到 Git 或打包进镜像，仍等于把钥匙和锁放一起：
- 优先使用 Nexus/Artifactory 的 Token 认证：有效期可控、作用域隔离、支持轮换，配置时只需
<username></username>+<password></password>填 token 值（无需加密） - CI 流水线中，通过环境变量（如
MAVEN_PASSWORD）或密钥管理器（Vault、AWS Secrets Manager）注入凭据，再用脚本动态生成临时settings.xml - 团队协作时，只共享不含
<password></password>的settings.xml模板，每人本地独立生成自己的安全文件
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
