讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

Maven settings.xml profiles profile repositories 仓库配置

冬伟酱_5678

冬伟酱_5678

发布时间:2026-03-10 06:29:11

|

576人浏览过

|

来源于php中文网

原创

profile不生效主因是未激活,需在settings.xml的activeProfiles中声明或用-P参数;repositories和pluginRepositories须分开配置;profile中repository优先级高于pom.xml,且不影响mirrors。

maven settings.xml profiles profile repositories 仓库配置

settings.xml 里 profile 不生效?先检查 activeProfiles

绝大多数 profile 配置失败,不是写错了,而是没激活。Maven 默认不自动启用任何 profile,哪怕它定义在 settings.xml 里。

必须显式声明激活方式:

  • 在 settings.xml 的 <activeprofiles></activeprofiles> 块中添加对应 <activeprofile>your-profile-id</activeprofile>
  • 或启动时加参数:mvn clean install -P your-profile-id
  • 注意:profile 的 id 必须严格匹配,区分大小写,且不能含空格或特殊字符

repositories 和 pluginRepositories 必须分开配

很多人只配了 <repositories></repositories>,结果 mvn archetype:generate 还是拉不到插件——因为 archetype 是插件,走的是 pluginRepositories 路径。

典型错误配置:

<profile>
  <id>nexus</id>
  <repositories>
    <repository>
      <id>nexus-repo</id>
      <url>https://nexus.example.com/repository/maven-public/</url>
    </repository>
  </repositories>
</profile>

正确做法是补上 pluginRepositories,且 id 和 url 通常要一致(尤其私有 Nexus):

  • <pluginrepositories></pluginrepositories> 块不能省,内容结构和 <repositories></repositories> 几乎一样
  • 如果用 Nexus,<pluginrepository></pluginrepository> 的 url 一般和 <repository></repository> 相同,除非你明确分开了插件仓库
  • 别漏掉 <releases><enabled>true</enabled></releases> 和 <snapshots><enabled>false</enabled></snapshots>,否则某些仓库会拒绝 SNAPSHOT 依赖

profile 中的 repository 优先级高于 pom.xml 里的同名配置

这是关键行为:一旦 profile 激活,它定义的 <repository></repository> 会覆盖项目 pom.xml 中同 id 的仓库地址,包括镜像逻辑。

常见踩坑点:

  • 你的 pom.xml 写了 <repository><id>central</id><url>https://repo1.maven.org/maven2/</url></repository>,但 profile 里也定义了 <id>central</id> 指向内网 Nexus —— Maven 就不会再去连中央仓库
  • 如果 profile 里没写 <id>central</id>,而只写了自定义 id,那 pom.xml 的 central 仍有效,但会被 mirrors 截流(见下一点)
  • profile 的 repository 不影响 mirrors 配置;如果 mirrors 把 central 映射到内网地址,profile 里再写一遍 central 就多余,还可能冲突

mirrors 和 profiles 别混着用

镜像(<mirror></mirror>)是全局重定向,profile 是条件加载;两者机制不同,强行套用容易失效。

比如想“只在测试环境用内网仓库”,有人在 profile 里配 <mirror></mirror> —— 这不行,<mirror></mirror> 只能放在 <mirrors></mirrors> 根节点下,profile 里不识别。

  • 要按环境切仓库,必须用 profile + <repositories></repositories>,而不是镜像
  • <mirror></mirror> 的 <mirrorof></mirrorof> 值要谨慎:写 * 会拦截所有仓库,包括 profile 里新加的;推荐用 external:* 或具体 id 列表
  • profile 激活后,它的 <repositories></repositories> 是直接加入仓库列表的,不受 <mirrorof></mirrorof> 控制——除非你把 <mirrorof></mirrorof> 设成 *
实际配置时最麻烦的,是 profile、mirror、pom 三层仓库定义之间的隐式覆盖关系。改一处,得同步核对另外两处是否还在按预期工作。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

4760

2025.09.15

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

409

2026.05.09

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5184

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

6737

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2642

2024.11.28

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5610

2024.08.16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

60

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

60

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn