如何在不运行Quarkus的情况下验证指定生产配置Profile？

问题背景 #

将非原生Quarkus服务部署到生产环境时，遇到类路径下application.yaml中的生产配置Profile存在拼写错误，仅在启动对应环境服务时才暴露问题：

a.prop: value

"%prod-aws-1":
  a.prop: override-for-aws-1

"%prod-aws-2":
  a.prrop: override-for-aws-2 # 此处配置项拼写错误

开发、测试阶段因未触发prod-aws-2 Profile，未检测到该错误；启动生产环境服务时才出现配置映射失败。此外，尝试通过外部config/application.yaml添加正确配置修复时，Quarkus仍启动失败——因为类路径中的错误配置项无法被映射，限制了无需修改Jar包即可现场修复的能力。

核心需求：在开发阶段无需启动服务，即可验证特定Quarkus配置Profile的合法性，期望有类似quarkus config verify-profile prod-aws-2的CLI能力，提前发现配置映射错误。

可行解决方案 #

1. 使用Quarkus CLI的config dump命令验证指定Profile #

Quarkus CLI内置的config dump命令可加载指定Profile的所有配置，并标记未映射的配置项，无需启动服务即可完成验证：

quarkus config dump --profile=prod-aws-2

执行该命令后，输出会将所有配置分为已映射和未映射两类，拼写错误的a.prrop会被归为未配置项，直接暴露问题。

2. 编写单元测试提前验证Profile配置 #

通过单元测试在构建阶段验证指定Profile的配置映射，无需启动完整服务：

import io.quarkus.test.junit.QuarkusTest;
import io.quarkus.test.junit.TestProfile;
import jakarta.inject.Inject;
import org.eclipse.microprofile.config.Config;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

@QuarkusTest
@TestProfile(ProdAws2Profile.class)
public class ProdAws2ConfigValidationTest {

    @Inject
    Config config;

    @Test
    void validateProfileConfig() {
        // 验证正确配置项是否加载
        Assertions.assertEquals("override-for-aws-2", config.getValue("a.prop", String.class));

        // 检查是否存在未映射的配置项
        var unmappedConfigs = config.getConfigSources().stream()
                .flatMap(source -> source.getPropertyNames().stream())
                .filter(prop -> !config.isPropertyPresent(prop))
                .toList();

        Assertions.assertTrue(unmappedConfigs.isEmpty(), "发现未映射配置项: " + unmappedConfigs);
    }

    // 定义测试用的Profile
    public static class ProdAws2Profile implements io.quarkus.test.junit.Profile {
        @Override
        public String getName() {
            return "prod-aws-2";
        }
    }
}

运行该测试时，Quarkus会加载指定Profile的配置，若存在拼写错误的未映射项，测试会直接失败，提前在开发阶段发现问题。

3. 开启构建时严格配置检查 #

通过启用Quarkus的严格配置模式，在构建阶段就检查所有Profile的配置项是否合法，避免生产环境才暴露问题：
在类路径的application.yaml中添加：

quarkus.config.strict: true

执行quarkus build时，Quarkus会扫描所有配置项，包括各Profile下的内容，若发现未映射的配置项（如a.prrop），会直接在构建阶段抛出错误，强制修复问题。

现场修复类路径错误配置的临时方案 #

若已部署到生产环境，无法修改Jar包中的配置，可通过外部配置添加quarkus.config.ignore-unknown=true，忽略未映射的配置项：
在外部config/application.yaml中添加：

quarkus.config.ignore-unknown: true
a.prop: override-for-aws-2

这样Quarkus会跳过类路径中的错误配置项，优先使用外部的正确配置，完成现场修复。

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