Quarkus测试环境profile配置无法覆盖环境变量问题咨询

问题成因 #

Quarkus存在默认的配置源优先级规则，优先级从高到低排序为：

1. 命令行传入的系统属性（即-Dxxx=xxx形式的参数）
2. 操作系统环境变量
3. 带profile前缀的配置项、对应profile专属配置文件（比如%test.前缀的配置、application-test.properties中的配置）
4. 主配置文件application.properties中的普通配置项
   环境变量的优先级天生高于test profile的配置，所以只要对应环境变量存在，就会覆盖你配置的test profile值，这就是问题的根本原因。

解决方案 #

方案1：命令行传参强制覆盖（适合配置项少的场景） #

由于系统属性优先级高于环境变量，你可以直接把需要强制生效的测试配置以命令行参数的形式传入，测试命令改为：

mvn -Dquarkus.test.profile=test -Dmy.property=dummyValue clean verify

如果需要覆盖的配置项较多，你可以把所有强制生效的测试配置整理为单独的属性文件，通过配置路径参数加载即可，该文件内的配置优先级会高于环境变量：

mvn -Dquarkus.test.profile=test -Dquarkus.config.locations=file:./src/test/resources/test-force.properties clean verify

方案2：自定义高优先级测试配置源（适合配置项多的长期维护场景） #

你可以在测试代码路径下自定义配置源，指定它的优先级高于环境变量，后续无需修改测试执行命令：

1. 新建测试配置源类src/test/java/com/你的包名/TestHighPriorityConfigSource.java

package com.yourpackage;

import org.eclipse.microprofile.config.spi.ConfigSource;
import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Map;
import java.util.Properties;

public class TestHighPriorityConfigSource implements ConfigSource {
    private final Map<String, String> configMap;

    public TestHighPriorityConfigSource() throws IOException {
        configMap = new HashMap<>();
        try (InputStream inputStream = getClass().getResourceAsStream("/application-test-force.properties")) {
            Properties properties = new Properties();
            properties.load(inputStream);
            properties.forEach((key, value) -> configMap.put(key.toString(), value.toString()));
        }
    }

    @Override
    public Map<String, String> getProperties() {
        return configMap;
    }

    @Override
    public String getValue(String propertyName) {
        return configMap.get(propertyName);
    }

    @Override
    public String getName() {
        return "test-high-priority-config";
    }

    // 优先级设为350，高于环境变量的默认优先级300
    @Override
    public int getOrdinal() {
        return 350;
    }
}

2. 新建服务注册文件src/test/resources/META-INF/services/org.eclipse.microprofile.config.spi.ConfigSource，文件内容填写你刚才创建的配置源全类名：

com.yourpackage.TestHighPriorityConfigSource

3. 把所有需要优先级高于环境变量的测试配置放到src/test/resources/application-test-force.properties中即可。

方案3：CI流水线临时清理环境变量（适合CI运行场景） #

如果仅在CI/CD流水线运行时出现问题，你可以在执行测试命令的步骤前，临时清空会干扰测试的环境变量，以bash环境为例：

unset MY_PROPERTY
mvn -Dquarkus.test.profile=test clean verify

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