本文详解如何通过 <mirror> 配合 blocked=true 彻底禁用 Maven 默认中央仓库回退行为，确保依赖仅从激活 Profile 中定义的仓库解析，缺失时直接报错而非静默降级。
本文详解如何通过 `
在多环境构建中，一个常见且关键的需求是：当指定 Profile（如 profile1）被激活时，Maven 必须严格只从该 Profile 内声明的 <repository> 解析依赖；若目标 artifact 在该仓库中不存在，应立即失败报错，而非回退到 pom.xml 中定义的 central 仓库或本地缓存。默认情况下，Maven 的仓库解析策略是“链式回退”（fallback chain）：先查 Profile 激活的仓库 → 再查 pom.xml 中的仓库 → 最后查中央仓库（除非显式屏蔽）。这与“强约束型环境校验”场景相悖——例如 CI/CD 流水线需验证私有制品库是否完整托管所有依赖。
✅ 正确解法：使用 blocked=true 镜像拦截中央仓库
核心思路不是“删除 central”，而是主动拦截并阻断其网络请求。Maven 提供了 <mirror> 的 blocked="true" 属性，这是官方支持的、语义明确的强制阻断机制：
<!-- settings.xml -->
<settings>
<!-- ... 其他配置 -->
<mirrors>
<!-- 关键：拦截并阻断 central 仓库的所有请求 -->
<mirror>
<id>blocked-central</id>
<name>Blocked Maven Central Mirror</name>
<url>https://0.0.0.0</url>
<mirrorOf>central</mirrorOf>
<blocked>true</blocked>
</mirror>
</mirrors>
<profiles>
<profile>
<id>profile1</id>
<repositories>
<repository>
<id>profile1-repo</id>
<url>https://maven.repository-of-profile1/repository</url>
<releases><enabled>true</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</repository>
</repositories>
<!-- 注意：pluginRepositories 同样需要配置，否则 archetype 等插件会失败 -->
<pluginRepositories>
<pluginRepository>
<id>profile1-repo</id>
<url>https://maven.repository-of-profile1/repository</url>
<releases><enabled>true</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
<profile>
<id>profile2</id>
<repositories>
<repository>
<id>profile2-repo</id>
<url>https://maven.repository-of-profile2/repository</url>
<releases><enabled>true</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>profile2-repo</id>
<url>https://maven.repository-of-profile2/repository</url>
<releases><enabled>true</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
<servers>
<server>
<id>profile1-repo</id>
<username>user1</username>
<password>pass1</password>
</server>
<server>
<id>profile2-repo</id>
<username>user2</username>
<password>pass2</password>
</server>
</servers>
</settings>⚠️ 重要说明：
- <mirrorOf>central</mirrorOf> 必须与 pom.xml 中 <repository> 的 <id> 完全一致（此处为 central）；
- <url>https://0.0.0.0</url> 是占位地址，配合 blocked=true 即可触发阻断逻辑，无需真实可达；
- blocked=true 是 Maven 3.0.3+ 的标准属性，它会使 Maven 在解析 central 时直接抛出 RepositoryNotFoundException，而非尝试连接或降级；
- 若 pom.xml 中未声明 central，而使用了其他 ID（如 maven-central），则 <mirrorOf> 需同步改为对应 ID。
✅ 验证方式：使用 dependency:get 显式测试
执行以下命令，将严格只查询 profile1-repo：
mvn -s ~/.m2/settings.xml -P profile1 dependency:get \ -DgroupId=com.example \ -DartifactId=missing-artifact \ -Dversion=1.2.3-SNAPSHOT
✅ 预期结果：
- 若 artifact 存在于 profile1-repo → 成功下载；
- 若不存在 → 报错类似：
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-dependency-plugin:3.6.1:get (default-cli): Plugin org.apache.maven.plugins:maven-dependency-plugin:3.6.1 or one of its dependencies could not be resolved: Could not find artifact com.example:missing-artifact:jar:1.2.3-SNAPSHOT in profile1-repo (https://maven.repository-of-profile1/repository)
❌ 不会出现：... trying central ... 或 ... using local cache ... 等回退日志。
? 补充最佳实践
- Profile 必须显式激活：-P profile1 不可省略，activeByDefault=true 在 settings.xml 中仅当无 -P 参数时生效，且易被覆盖；
- <servers> 必须在 <settings> 顶层：Profile 内不能定义 server，但可通过 <id> 引用；确保 server.id 与 repository.id 严格一致；
- 始终配置 <pluginRepositories>：否则 mvn archetype:generate 或插件解析仍会 fallback 到中央仓库；
- *避免 <mirrors> 误配 `**：
* ` 会劫持所有仓库（包括 profile 自定义仓库），导致不可预期行为，务必精确匹配 ID。
通过 blocked=true 镜像机制，你获得了对依赖解析路径的完全控制权——这不是 hack，而是 Maven 原生支持的、生产就绪的强制隔离方案。
