Quarkus中Configuration Bean相关问题及配置实现方式咨询

1. Quarkus是否提供Configuration Bean？ #

Quarkus完全兼容CDI规范，同时基于Eclipse MicroProfile Config实现了类型安全的配置Bean能力，官方称为配置映射（Configuration Mapping），完全可以满足你对Configuration Bean的使用需求。相比零散的单个配置项注入，配置Bean更利于同前缀配置的统一管理，也符合CDI的类型安全设计理念。
另外Quarkus 1.x版本还提供了@ConfigProperties注解实现类似能力，2.x之后官方更推荐使用功能更完善的@ConfigMapping。

2. 常见配置操作实现方式 #

2.1 单个配置项注入 #

如果仅需要注入零散的配置值，直接使用@ConfigProperty注解即可：

import org.eclipse.microprofile.config.inject.ConfigProperty;
import jakarta.enterprise.context.ApplicationScoped;

@ApplicationScoped
public class MyBizService {
    // 注入配置项app.service.timeout，未配置时默认使用3000作为值
    @ConfigProperty(name = "app.service.timeout", defaultValue = "3000")
    Long requestTimeout;
}

2.2 类型安全配置Bean使用 #

如果需要统一管理同前缀的一组配置，优先使用配置映射（即Configuration Bean）：

1. 首先定义配置映射接口

import io.smallrye.config.ConfigMapping;
import io.smallrye.config.WithName;
import io.smallrye.config.WithDefault;

// 指定配置前缀为app.datasource，所有配置项会匹配该前缀下的key
@ConfigMapping(prefix = "app.datasource")
public interface DataSourceConfig {
    // 匹配app.datasource.url
    String url();
    // @WithName可自定义匹配的配置key，这里对应app.datasource.driver-class
    @WithName("driver-class")
    String driverClass();
    // @WithDefault可配置默认值，无对应配置项时直接使用该值
    @WithDefault("root")
    String username();
    String password();
}

2. 直接通过CDI注入使用即可

import jakarta.inject.Inject;
import jakarta.enterprise.context.ApplicationScoped;

@ApplicationScoped
public class JdbcService {
    @Inject
    DataSourceConfig dsConfig;

    public void initConn() {
        String jdbcUrl = dsConfig.url();
        String driver = dsConfig.driverClass();
        // 后续初始化逻辑
    }
}

2.3 配置来源优先级 #

Quarkus会按优先级从高到低从以下位置读取配置：

• 启动时传入的系统属性
• 操作系统环境变量
• 项目src/main/resources下的application.properties文件
• 项目src/main/resources下的application.yaml/application.yml文件（需提前引入quarkus-config-yaml依赖支持）

2.4 多环境配置切换 #

通过配置Profile实现多环境配置隔离：

• 新增对应环境的配置文件，如生产环境对应application-prod.properties、测试环境对应application-test.properties
• 启动时指定激活的Profile即可：
  java -Dquarkus.profile=prod -jar your-quarkus-app-runner.jar

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