Maven多模块项目跨模块测试属性管理及CI/CD问题解决

开发者阿泽

2026-6-17

Maven多模块项目测试属性加载与共享管理问题

项目背景

项目结构如下：

service
├── network
│   ├── src
│   │   ├── main
│   │   ├── test
│   │   │   └── resources
│   │   │       └── application-bridge-to-bridge-test.properties
│   └── resources
├── devenv
│   └── resources
│       └── application.properties (包含生产所需全部属性)
└── pom.xml

需求：network模块的测试需要先加载devenv的application.properties初始化基础属性，再用测试专属的application-bridge-to-bridge-test.properties覆盖部分值。

本地实现方式：在测试类添加注解：

@TestPropertySource(locations = {
        "file:../devenv/src/main/resources/application.properties",
        "classpath:application-bridge-to-bridge-test.properties"
})

问题：本地运行正常，但CI/CD流水线触发测试时抛出异常：

java.lang.IllegalStateException: Failed to add PropertySource to Environment...

约束：network是devenv的依赖，无法引入devenv模块，否则会产生循环依赖导致构建失败。

问题解答

1. 解决CI/CD测试运行异常的方案

本地使用的相对路径file:../devenv/...依赖固定目录结构，但CI环境中可能存在构建目录差异（比如模块单独构建、工作目录层级变化），导致文件找不到。可以通过Maven资源复制插件，在测试阶段将devenv的属性文件复制到network的测试类路径中，统一用classpath引用。

步骤1：在network模块的pom.xml中添加资源复制配置

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <executions>
                <execution>
                    <id>copy-devenv-properties</id>
                    <phase>process-test-resources</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.testOutputDirectory}</outputDirectory>
                        <resources>
                            <resource>
                                <directory>${project.parent.basedir}/devenv/resources</directory>
                                <includes>
                                    <include>application.properties</include>
                                </includes>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

该配置会在process-test-resources阶段，将父目录下devenv模块的application.properties复制到network模块的target/test-classes目录下，确保测试时能通过classpath访问到。

步骤2：修改测试类的注解

将文件路径改为classpath引用，消除对本地目录结构的依赖：

@TestPropertySource(locations = {
        "classpath:application.properties",
        "classpath:application-bridge-to-bridge-test.properties"
})

这样本地和CI环境都会从测试类路径加载文件，避免路径问题。

2. 模块间共享属性的最佳实践

针对多模块间属性重复、同步困难的问题，推荐以下几种方案：

方案1：抽离共享属性到独立基础模块

新建一个common-config模块，将所有共享属性放在该模块的src/main/resources下（比如application-common.properties），然后让network和devenv都依赖这个模块：

devenv的application.properties通过Spring配置导入功能引入共享属性：
```
spring.config.import=classpath:application-common.properties
```

network测试时，直接引用application-common.properties作为基础配置，再叠加测试专属属性：

@TestPropertySource(locations = {
        "classpath:application-common.properties",
        "classpath:application-bridge-to-bridge-test.properties"
})

所有共享属性只需在common-config中维护一份，避免重复和遗漏。

方案2：使用Maven属性统一管理

在父pom.xml中定义所有共享属性值，然后各个模块的属性文件通过Maven资源过滤引用这些值：

父pom.xml中定义属性：

<properties>
    <db.url>jdbc:mysql://localhost:3306/mydb</db.url>
    <redis.host>localhost</redis.host>
    <redis.port>6379</redis.port>
</properties>

在network和devenv模块的pom.xml中开启资源过滤：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
    </resources>
    <!-- 测试资源需要过滤的话，添加以下配置 -->
    <testResources>
        <testResource>
            <directory>src/test/resources</directory>
            <filtering>true</filtering>
        </testResource>
    </testResources>
</build>

在属性文件中引用Maven属性：

db.url=${db.url}
redis.host=${redis.host}
redis.port=${redis.port}

共享属性在父pom中统一维护，模块只需引用，避免手动同步。

方案3：利用Spring Boot配置分层（适用于Spring Boot项目）

如果是Spring Boot项目，可利用profile或配置导入的分层能力：

把共享配置作为application-default.properties放在公共位置，Spring Boot会自动加载默认配置；
各个模块的配置只保留差异化内容，无需重复共享属性；
测试时可通过@ActiveProfiles指定测试专属profile，或直接叠加测试配置文件。

内容的提问来源于stack exchange，提问作者Daniel Simantov