Quarkus原生镜像下无法通过环境变量覆盖配置属性？

核心结论 #

Quarkus原生镜像支持通过环境变量覆盖配置属性，但quarkus.profile属于构建时属性，原生编译阶段会将其固化，无法直接通过QUARKUS_PROFILE环境变量在运行时修改。

问题原因 #

quarkus.profile是Quarkus的构建时属性，当你以native profile编译应用时，Quarkus会基于该profile的配置完成原生镜像的构建，包括依赖裁剪、配置固化等操作。运行时环境变量无法覆盖这类构建阶段就确定的属性，所以即使你设置了QUARKUS_PROFILE=FR2，应用依然会使用编译时的prod值。

解决方案 #

要在原生镜像运行时动态切换profile，需要使用运行时激活profile的方式：

• 使用环境变量 QUARKUS_PROFILE_ACTIVE=FR2 来指定运行时激活的profile
• 确保对应profile的配置文件（如application-FR2.properties）已被正确包含在原生镜像中（Quarkus编译时默认会打包所有profile的配置文件，无需额外配置）

代码验证调整 #

如果需要在代码中获取运行时激活的profile，可以修改你的Configuration类：

@Singleton
public class Configuration {

    @ConfigProperty(name = "quarkus.profile")
    public String buildTimeProfile; // 编译时固化的profile值

    @ConfigProperty(name = "quarkus.profile.active")
    public String runtimeActiveProfile; // 运行时激活的profile值

    @Override
    public String toString() {
        return "Configuration:\n" +
                "buildTimeProfile='" + buildTimeProfile + "'\n" +
                "runtimeActiveProfile='" + runtimeActiveProfile + "'\n";
    }
}

常规配置的环境变量覆盖验证 #

对于普通的运行时配置属性（非构建时属性），原生镜像支持环境变量覆盖：

1. 定义配置：

@ConfigProperty(name = "app.custom.value")
public String customValue;

2. 运行容器时设置环境变量 APP_CUSTOM_VALUE=my-dynamic-value，应用就能正确获取到该值。

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