Quarkus测试在GitLab流水线中意外读取GitLab变量问题排查

核心原因 #

Quarkus的配置加载有明确的优先级规则，系统环境变量的优先级高于所有配置文件——包括测试环境的src/test/resources/application.properties。GitLab流水线运行时，会自动将你定义的项目变量MY_PROPERTY注入为当前运行环境的系统环境变量。所以不管你在测试配置里写了my-property=FOO，甚至删除了所有配置文件中的相关设置，Quarkus都会优先读取环境变量MY_PROPERTY的值（也就是BAR）。

解决办法 #

1. 流水线测试阶段临时覆盖环境变量 #

在.gitlab-ci.yml的测试任务中，临时将MY_PROPERTY设置为FOO，覆盖GitLab的项目变量：

test:
  script:
    - export MY_PROPERTY=FOO
    - mvn test

这样测试环节的环境变量被临时替换，Quarkus会读取到FOO。

2. 测试代码中直接覆盖配置 #

使用Quarkus测试专用的@OverrideConfigProperty注解，在测试类中强制指定属性值，优先级最高，不受环境变量影响：

import io.quarkus.test.junit.QuarkusTest;
import io.quarkus.test.junit.OverrideConfigProperty;

@QuarkusTest
@OverrideConfigProperty(name = "my-property", value = "FOO")
public class YourTestClass {
    // 测试逻辑
}

3. 流水线测试阶段取消变量注入（不推荐） #

如果测试不需要MY_PROPERTY变量，可以在测试job中清空该变量：

test:
  variables:
    MY_PROPERTY: ""
  script:
    - mvn test

但这种方式可能影响其他依赖该变量的测试逻辑，需谨慎使用。

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