根本原因是镜像配置覆盖私服地址——settings.xml中*会强制重定向所有请求，导致profiles定义的私服repository失效；应改为central或注释掉该行，并确保profile激活、server id匹配、nexus权限与仓库策略正确。
为什么 settings.xml 里配了 Gitee 私服却还是拉不到依赖
根本原因通常是镜像配置覆盖了私服地址——Maven 默认会把所有请求重定向到 mirrorOf *，哪怕你已经在 profiles 里声明了私服 repository，它也进不去。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 检查
settings.xml的<mirrors></mirrors>区块，删掉或注释掉<mirrorof>*</mirrorof>这一行；如果必须保留镜像（比如用阿里云镜像加速中央仓），改成<mirrorof>central</mirrorof>，避免通配覆盖 - 确保私服的
id（如gitee-nexus）在<profiles></profiles>和<activeprofiles></activeprofiles>中完全一致，大小写敏感 - Gitee 自建私服一般跑在 Nexus 或 Sonatype Nexus Repository Manager 上，确认服务已启动、
http://your-nexus:8081/repository/maven-public/能浏览器直连且返回 200
怎么让 Maven 项目真正走 Gitee 私服而不是中央仓库
关键不在 pom.xml 写不写 <repositories></repositories>，而在于 settings.xml 是否启用 profile 并正确绑定分发策略。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在
settings.xml的<profiles></profiles>里定义一个 profile，包含<repositories></repositories>和<pluginrepositories></pluginrepositories>，其中url指向你的 Gitee 私服仓库地址，比如http://nexus.example.com/repository/maven-releases/ - 在同一个 profile 里加
<properties></properties>设置maven.repo.local（可选，用于隔离本地缓存） - 必须在
<activeprofiles></activeprofiles>中显式激活该 profile，只写<profile></profile>不激活等于没配 - 验证方式：执行
mvn help:effective-settings，看输出里是否出现你配的repository地址和对应id
deploy 到 Gitee 私服失败：401 或 405 错误怎么解
401 是认证失败，405 是 HTTP 方法不支持——两者都指向 settings.xml 的 <servers></servers> 配置没对上私服要求的账号权限或部署路径。
实操建议：
立即学习“Java免费学习笔记（深入）”；
-
<servers></servers>中的id必须和<distributionmanagement></distributionmanagement>里的repository/snapshots的id完全一致（例如都是gitee-release） - Nexus 默认关闭匿名部署，需在 Nexus 管理界面为对应仓库（如
maven-releases）开启 “Deployment Policy” 为 “Allow redeploy” 或 “Disable redeploy”，并分配 deploy 权限给对应用户 - 密码不能明文写在
settings.xml，要用 Maven 加密：先运行mvn --encrypt-master-password生成主密钥，再用mvn --encrypt-password加密实际密码，填入<server></server>的<password></password> - 确认
pom.xml中<distributionmanagement></distributionmanagement>的<url></url>是 release 仓库（如/repository/maven-releases/），不是 group 或 proxy 仓库地址
Java 项目里引用私服依赖时编译报错：找不到类或版本不对
常见于多模块项目或 snapshot 依赖未及时更新，本质是本地 .m2 缓存与私服状态不同步，或私服仓库策略限制了 snapshot 分辨率。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 执行
mvn clean compile -U，强制更新快照依赖（-U参数不可省） - 检查 Nexus 中对应仓库的 “Version Policy”：release 仓库不能存 snapshot，snapshot 仓库不能存 release，否则 Maven 会跳过解析
- IDE（如 IntelliJ）可能缓存了旧的依赖索引，点击
Maven → Reload project，或删掉.idea/libraries/下相关 xml 文件再重载 - 如果依赖是自己 deploy 的，确认
pom.xml的<groupid></groupid>、<artifactid></artifactid>、<version></version>和 deploy 时完全一致，Nexus 不校验 POM 内容，只认坐标
私服配置最麻烦的从来不是写几行 XML，而是 Nexus 权限、仓库类型、Maven 生命周期阶段、IDE 缓存这四层叠加后产生的“看起来配对了其实没生效”的状态。每次改完记得用 mvn help:effective-pom 和 mvn help:effective-settings 对照看真实生效的配置，比猜强得多。
