maven中profile的使用详解

最新推荐文章于 2025-03-11 18:23:36 发布
最新推荐文章于 2025-03-11 18:23:36 发布
阅读量6.6k 收藏 12
点赞数
分类专栏： Maven 文章标签： maven
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/w727655308/article/details/121584782
版权
本文详细介绍了Maven中profile的功能，包括配置结构、定义位置、激活方式和查看激活状态。重点展示了如何根据环境打包配置文件和资源目录选择，提升部署效率并减少错误。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

maven中profile使用详解


1. profile语法

  1. 项目在不同环境，比如开发环境、测试环境、生产环境，有的配置可能会不一样，比如数据源配置、日志文件配置、以及一些软件运行过程中的基本配置
  2. 每次我们部署到不同环境时, 都需要修改相应的配置文件，这样来回修改，很容易出错，而且浪费劳动力
  3. 而maven也提供了一种灵活的解决方案，也就是profile功能

1.1 profile中的配置结构

基本囊括所有pom中可以定义的元素, 根据不同profile, 生效的元素不一样

<project>
    <profiles>
        <profile>
            <build>
                <defaultGoal>...</defaultGoal>
                <finalName>...</finalName>
                <resources>...</resources>
                <testResources>...</testResources>
                <plugins>...</plugins>
            </build>
            <reporting>...</reporting>
            <modules>...</modules>
            <dependencies>...</dependencies>
            <dependencyManagement>...</dependencyManagement>
            <distributionManagement>...</distributionManagement>
            <repositories>...</repositories>
            <pluginRepositories>...</pluginRepositories>
            <properties>...</properties>
        </profile>
    </profiles>
</project>

1.2 profile的定义位置

我们可以有多个地方定义profile。定义的地方不同，它的作用范围也不同。

  1. 针对于特定项目的profile配置我们可以定义在该项目的pom.xml中。
  2. 针对于特定用户的profile配置，我们可以在用户的settings.xml文件中定义profile。该文件在用户家目录下的“.m2”目录下。
  3. 全局的profile配置。全局的profile是定义在Maven安装目录下的“conf/settings.xml”文件中的。

其中profile中能够定义的配置信息, 跟profile所处的位置是相关的。

以下就分两种情况来讨论，一种是定义在settings.xml中，另一种是定义在pom.xml中。

  • profile定义在settings.xml中

当profile定义在settings.xml中时意味着该profile是全局的，它会对所有项目或者某一用户的所有项目都产生作用。因为它是全局的，所以在settings.xml中只能定义一些相对而言范围宽泛一点的配置信息，比如远程仓库等。而一些比较细致一点的需要根据项目的不同来定义的就需要定义在项目的pom.xml中。具体而言，能够定义在settings.xml中的信息有<repositories>、<pluginRepositories>和<properties>。定义在<properties>里面的键值对可以在pom.xml中使用。


  • profile定义在pom.xml中

定义在pom.xml中的profile可以定义更多的信息。主要有以下这些：

<repositories>
<pluginRepositories>
<dependencies>
<plugins>
<properties>
<dependencyManagement>
<distributionManagement>
还有build元素下面的子元素，主要包括：
<defaultGoal>
<resources>
<testResources>
<finalName>

1.3 如何激活profile

  • profile定义中使用activeByDefault默认激活
<profiles> 
    <profile> 
        <id>profileTest1</id> 
        <properties> 
            <hello>world</hello> 
        </properties> 
        <activation> 
            <activeByDefault>true</activeByDefault> 
        </activation> 
    </profile> 

    <profile> 
        <id>profileTest2</id> 
        <properties> 
            <hello>andy</hello> 
        </properties> 
    </profile> 
</profiles>

activeByDefault为true的时候就表示当没有指定其他profile为激活状态时，该profile就默认会被激活。所以当我们调用mvn package的时候上面的profileTest1将会被激活，但是当我们使用mvn package –P profileTest2的时候将激活profileTest2，而这个时候profileTest1将不会被激活


  • 在settings.xml中使用activeProfiles指定激活的profile
<profiles> 
    <profile> 
        <id>profileTest1</id> 
        <properties> 
            <hello>world</hello> 
        </properties> 
    </profile> 

    <profile> 
        <id>profileTest2</id> 
        <properties> 
            <hello>andy</hello> 
        </properties> 
    </profile> 
</profiles>

这里的profile可以是定义在settings.xml中的，也可以是定义在pom.xml中的。这个时候如果我们需要指定profileTest1为激活状态，那么我们就可以在settings.xml中定义activeProfiles，具体定义如下：

<activeProfiles> 
    <activeProfile>profileTest1</activeProfile> 
</activeProfiles>

考虑这样一种情况，我们在activeProfiles下同时定义了多个需要激活的profile。这里还拿上面的profile定义来举例，我们定义了同时激活profileTest1和profileTest2。

<activeProfiles> 
    <activeProfile>profileTest1</activeProfile> 
    <activeProfile>profileTest2</activeProfile> 
</activeProfiles>

从profileTest1和profileTest2我们可以看出它们共同定义了属性hello。那么这个时候我在pom.xml中使用属性hello的时候，它到底取的哪个值呢？是根据activeProfile定义的顺序，后面的覆盖前面的吗？根据我的测试，答案是非也，它是根据profile定义的先后顺序来进行覆盖取值的，然后后面定义的会覆盖前面定义的。


  • 使用-P参数显示的激活一个profile

我们在进行Maven操作时就可以使用-P参数显示的指定当前激活的是哪一个profile了。比如我们需要在对项目进行打包的时候使用id为profileTest1的profile，我们就可以这样做 (P后面可以有空格也可以没有)：

mvn package –P profileTest1

当我们使用activeByDefault或settings.xml中定义了处于激活的profile，但是当我们在进行某些操作的时候又不想它处于激活状态，这个时候我们可以这样做：

Mvn package –P !profileTest1

这里假设profileTest1是在settings.xml中使用activeProfile标记的处于激活状态的profile，那么当我们使用-P !profile的时候就表示在当前作中该profile将不处于激活状态。


1.4 查看当前处于激活状态的profile

我们可以同时定义多个profile，那么在建立项目的过程中，到底激活的是哪一个profile呢？Maven为我们提供了一个指令可以查看当前处于激活状态的profile都有哪些，这个指定就是mvn help:active-profiles。


这里有个误区要特别注意: 同时激活的profile可以是多个, 它们可能是不同维度的. 如某个profile是用来管理repository的, 某个profile是管理某些properties的.


2. 具体使用场景


2.1 根据环境打包配置文件

  • 项目结构
test-profile
├── pom.xml
├── src
│   ├── main
│   │   ├── config
│   │   │   ├── dev
│   │   │   │   └── redis.properties
│   │   │   ├── fat
│   │   │   │   └── redis.properties
│   │   │   ├── prd
│   │   │   │   └── redis.properties
│   │   │   └── uat
│   │   │       └── redis.properties
│   │   ├── java
│   │   └── resources
│   │       ├── dev
│   │       │   └── jdbc.properties
│   │       ├── fat
│   │       │   └── jdbc.properties
│   │       ├── prd
│   │       │   └── jdbc.properties
│   │       └── uat
│   │           └── jdbc.properties
│   └── test
├── target

  • pom中配置profile

示例如下:

profile的id代表不同的环境, 每个profile定义了不同变量值

打包时根据变量值选择打包目录

  <build>
        <finalName>test-profile</finalName>
        <plugins>
            <plugin>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.2</version>
                <configuration>
                    <failOnMissingWebXml>false</failOnMissingWebXml>
                    <webResources>
                        <resource>
                            <directory>src/main/config/${running.env}</directory>
                            <targetPath>WEB-INF/classes</targetPath>
                        </resource>
                    </webResources>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <profiles>
        <profile>
            <id>dev</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <running.env>dev</running.env>
            </properties>
        </profile>
        <profile>
            <id>test</id>
            <properties>
                <running.env>fat</running.env>
            </properties>
        </profile>
        <profile>
            <id>pp</id>
            <properties>
                <running.env>uat</running.env>
            </properties>
        </profile>
        <profile>
            <id>product</id>
            <properties>
                <running.env>prd</running.env>
            </properties>
        </profile>
    </profiles>

  • 打包

运行mvn clean package (默认profile) 或 mvn clean package -Ptest (指定profie) 打包后, 结构如下:

resource的目录全部打包到class目录中, config目录根据profile配置只有一个目录下的文件打包到class目录中

test-profile
├── META-INF
└── WEB-INF
    └── classes
        ├── dev
        │   └── jdbc.properties
        ├── fat
        │   └── jdbc.properties
        ├── prd
        │   └── jdbc.properties
        ├── redis.properties
        └── uat
            └── jdbc.properties

2.2 resources目录中选择目录打包

上述中的config目录未在resource打包默认的目录中, 所以会根据profile根据配置进行选择.

如果需要在resource打包默认的目录src/main/resouces下, 根据不同profile选择不同目录的配置. 则需要结合resource插件一起使用.

  • pom中结合resources一起使用

pom中增加resource, 先把需要选择的所有目录排除掉, 再根据profile选择目录

<build>
        <finalName>test-profile</finalName>

        <resources>
            <resource>
                <directory>src/main/resources/</directory>
                <!--打包时先排除掉三个文件夹-->
                <excludes>
                    <exclude>dev/*</exclude>
                    <exclude>fat/*</exclude>
                    <exclude>prd/*</exclude>
                    <exclude>uat/*</exclude>
                </excludes>
                <includes>
                    <!--如果有其他定义通用文件，需要包含进来-->
                    <!--<include>messages/*</include>-->
                </includes>
            </resource>

            <resource>
                <!--这里是关键！ 根据不同的环境，把对应文件夹里的配置文件打包-->
                <directory>src/main/resources/${running.env}</directory>
            </resource>

        </resources>
        <plugins>
            <plugin>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.2</version>
                <configuration>
                    <failOnMissingWebXml>false</failOnMissingWebXml>
                    <webResources>
                        <resource>
                            <directory>src/main/config/${running.env}</directory>
                            <targetPath>WEB-INF/classes</targetPath>
                        </resource>
                    </webResources>
                </configuration>
            </plugin>
        </plugins>
    </build>


    <profiles>
        <profile>
            <id>dev</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <running.env>dev</running.env>
            </properties>
        </profile>
        <profile>
            <id>test</id>
            <properties>
                <running.env>fat</running.env>
            </properties>
        </profile>
        <profile>
            <id>pp</id>
            <properties>
                <running.env>uat</running.env>
            </properties>
        </profile>
        <profile>
            <id>product</id>
            <properties>
                <running.env>prd</running.env>
            </properties>
        </profile>
    </profiles>

  • 打包

项目结构不变, 运行mvn clean package (默认profile) 或 mvn clean package -Ptest (指定profie) 打包后, 结构如下:

target/test-profile
├── META-INF
└── WEB-INF
    └── classes
        ├── jdbc.properties
        └── redis.properties
Maven学习总结（49）——Maven Profile详解
科技D人生
11-04 3648
前言 Profile能让你为一个特殊的环境自定义一个特殊的构建；profile使得不同环境间构建的可移植性成为可能。Maven中的profile是一组可选的配置，可以用来设置或者覆盖配置默认值。有了profile，你就可以为不同的环境定制构建。profile可以在pom.xml中配置，并给定一个id。然后你就可以在运行Maven的时候使用的命令行标记告诉Maven运行特定profile中的目标。...
Maven 插件列表详解
栗筝i的博客
06-19 3510
Maven 是一个强大的项目管理和构建工具，广泛应用于 Java 项目中。作为一款优秀的构建管理工具，Maven 不仅提供了标准化的项目结构和依赖管理，还通过其丰富的插件系统，极大地扩展了其功能和灵活性。无论是代码编译、测试、打包，还是部署、报告生成，Maven 插件都扮演着不可或缺的角色。 本文将深入探讨 Maven 的插件体系，详细介绍各类插件的用途、主要目标和适用的生命周期阶段。内容涵盖了 Maven 官方插件、被淘汰的插件、社区驱动的 MojoHaus 插件、国内外企业开发的非官方插件以及如何自定
maven-profiler:记录Maven mojos执行时间
05-16
Maven探查器 Maven的时间执行记录器，它记录构建生命周期中每个mojo花费的时间。 安装 $M2_HOME指向maven安装文件夹。 . ├── bin ├── boot ├── conf └── lib OS X？ 您可以使用brew安装预包装的名为 。 它带有 ， 和 。 它基于最新的Maven版本。 brew tap jcgay/jcgay brew install maven-deluxe Maven> = 3.3.x 获取并将其复制到%M2_HOME%/lib/ext文件夹中。 或者 通过创建具有以下内容的${maven.multiModuleProjectDirectory}/.mvn/extensions.xml文件，使用新的： <?xml version="1.0" encoding="UTF-8"?> <extensions> <exte
maven profile的使用
moonpure的专栏
09-30 714
作为一名程序员，在开发的过程中，经常需要面对不同的运行环境（开发环境、测试环境、生产环境、内网环境、外网环境等等），在不同的环境中，相关的配置一般不一样，比如数据源配置、日志文件配置、以及一些软件运行过程中的基本配置。每次在不同环境部署程序时，都需要修改相应的配置文件，使之完成环境的配置。这么做存在一个比较大的问题：每次修改配置非常麻烦，而且配置错误会产生不可预估的影响，比如，在发布生产环境时用的
【Maven】profile，带你从0到1搞懂profile
最新发布
2302_79600390的博客
03-11 955
定义位置项目级：在pom.xml中定义，仅对当前项目有效。用户级：在用户目录的中定义，影响当前用户的所有项目。全局级：在Maven安装目录的中定义，影响所有项目。
Maven学习-Profile详解
weixin_34228662的博客
04-11 564
　　Profile能让你为一个特殊的环境自定义一个特殊的构建；profile使得不同环境间构建的可移植性成为可能。Maven中的profile是一组可选的配置，可以用来设置或者覆盖配置默认值。有了profile，你就可以为不同的环境定制构建。profile可以在pom.xml中配置，并给定一个id。然后你就可以在运行Maven的时候使用的命令行标记告诉Maven运行特定profile中的目标。一个...
Maven简介（三）——profile介绍
u014704496的专栏
11-05 747
4       profile介绍 4.1     profile简介 profile可以让我们定义一系列的配置信息，然后指定其激活条件。这样我们就可以定义多个profile，然后每个profile对应不同的激活条件和配置信息，从而达到不同环境使用不同配置信息的效果。比如说，我们可以通过profile定义在jdk1.5以上使用一套配置信息，在jdk1.5以下使用另外一套配置信息；或者有时候我们
Maven profile的使用
loetca
03-11 237
Maven profile的使用
Maven管理SpringBoot Profile详解
08-28
最后，需要在应用程序中使用 Maven Profile。在应用程序中，使用 Maven Profile 来管理 Spring Boot 项目的配置文件和依赖关系。 Maven 管理 Spring Boot Profile 是一个非常有用的机制，它可以帮助开发者更好地...
maven profile动态选择配置文件详解
08-25
Maven Profile 动态选择配置文件详解 Maven Profile 是 Maven 提供的一种功能，可以让我们定义一系列的配置信息，然后指定其激活条件。这样我们就可以定义多个 Profile，然后每个 Profile 对应不同的激活条件和配置...
Maven中的Profile机制详解
[Maven中的Profile机制详解](https://img-blog.csdnimg.cn/054d092df8de4c7eaf1f9e33e6764677.png) # 1. **介绍Maven Profile机制** Maven Profile 是 Maven 提供的一种机制，用于根据不同的环境或配置需求，定义和...
Maven中＜profiles＞与＜profile＞标签详解及案例测试
qq_41717518的博客
08-07 4784
首先我们知道，pom中可以使用诸如<properties>、<dependencies>、<build>来定义项目所需要的属性、依赖、构建设置。
maven中profiles使用详解
热门推荐
技术专栏
02-06 1万+
使用的场景 常常遇到一些项目中多环境切换的问题。比如在开发过程中用到开发环境，在测试中使用测试环境，在生产中用生产环境的情况。springboot中提供了 spring.profile.active的方式来实现多环境的切换，通过设置环境变量和启动参数的方式。但是这样做终究不能一劳永逸，要么需要修改yml文件，要么需要记得启动的时候带上参数。而利用maven的profiles，可以减少很多工作。让我们通过几个例子一步步的掌握使用maven的profiles属性。 快速上手 pom.xml文件设置 <pr
Maven的profiles多环境配置
t194978的博客
08-30 7080
一个项目通常都会有多个不同的运行环境，例如开发环境，测试环境、生产环境等。而不同环境的构建过程很可能是不同的，例如数据源配置、插件、以及依赖的版本等。每次将项目部署到不同的环境时，都需要修改相应的配置，这样重复的工作，不仅浪费劳动力，还容易出错。为了解决这一问题，Maven 引入了 Profile 的概念，通过它可以为不同的环境定制不同的构建过程。
使用Maven Profiles进行多环境构建
weixin_53840353的博客
07-12 1221
Maven Profiles是一种可以根据不同的条件激活或禁用一组配置的机制。这些条件可以是操作系统、JDK版本、系统属性等。Profiles通常定义在pom.xml文件中，可以覆盖或增加构建的配置。通过本文，我们了解了如何使用Maven Profiles进行多环境构建，并通过一个简单的Spring Boot示例展示了如何配置和使用不同的Profiles。Maven Profiles是一个非常强大的工具，可以帮助我们轻松管理和切换不同环境的配置，使得我们的构建过程更加灵活和高效。
maven中的profile
samnalove的专栏
10-26 2753
profile能为一个特殊的环境自定义一个特殊的构建，使得不同环境间构建的可移植性成为可能 profile可以覆盖几乎所有pom.xml中的配置，profiles元素通常是pom.xml的最后一个元素 每个profile必须有一个id，可以通过mvn ... -P 来调用 自动激活profile使用元素 激活参数可以是activeByDefault,jdk,
Eclipse集成Maven3插件使用详解
1. **集成Maven构建生命周期**：插件允许用户在Eclipse中直接使用Maven的命令和生命周期，如运行`mvn clean install`等。 2. **项目依赖管理**：插件提供了一种方式，让用户可以直观地管理项目依赖，包括添加、删除...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值