如何从Java SpringBoot应用读取Azure App Config特殊格式配置值

针对你遇到的Azure App Config键格式（如/application/config.datasource.jdbc-url），结合前缀为"config"的配置类，可通过以下两种方式读取配置：

方法一：使用@ConfigurationProperties（推荐） #

利用Spring Boot的@ConfigurationProperties特性，它支持自动将连字符格式（kebab-case）的配置键转换为驼峰命名（camelCase）的Java变量，同时支持嵌套层级结构。

代码示例 #

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "config")
public class ConfigProperties {
    private Datasource datasource;

    // 必须提供Getter/Setter，否则Spring无法注入嵌套对象
    public Datasource getDatasource() {
        return datasource;
    }

    public void setDatasource(Datasource datasource) {
        this.datasource = datasource;
    }

    // 嵌套内部类对应datasource层级配置
    public static class Datasource {
        // Spring自动映射config.datasource.jdbc-url到jdbcUrl
        private String jdbcUrl;
        private String password;
        private String username;

        // 为每个属性提供Getter/Setter
        public String getJdbcUrl() {
            return jdbcUrl;
        }

        public void setJdbcUrl(String jdbcUrl) {
            this.jdbcUrl = jdbcUrl;
        }

        public String getPassword() {
            return password;
        }

        public void setPassword(String password) {
            this.password = password;
        }

        public String getUsername() {
            return username;
        }

        public void setUsername(String username) {
            this.username = username;
        }
    }
}

说明 #

• 配置类前缀设为"config"，对应Azure App Config键中/application/之后的config部分；
• 嵌套的Datasource类对应config.datasource层级；
• 变量jdbcUrl自动匹配config.datasource.jdbc-url，Spring默认支持连字符转驼峰的映射规则；
• 必须为所有属性提供Getter/Setter，否则Spring无法完成属性注入。

方法二：使用@Value注解 #

如果只需要单独注入某个配置项，可以直接用@Value注解指定完整的配置键：

代码示例 #

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class ConfigProperties {
    @Value("${config.datasource.jdbc-url}")
    private String jdbcUrl;

    @Value("${config.datasource.password}")
    private String password;

    @Value("${config.datasource.username}")
    private String username;

    // 为每个属性提供Getter/Setter
    public String getJdbcUrl() {
        return jdbcUrl;
    }

    public void setJdbcUrl(String jdbcUrl) {
        this.jdbcUrl = jdbcUrl;
    }

    // 省略password和username的Getter/Setter
}

说明 #

• 直接通过${config.datasource.jdbc-url}指定完整键路径，无需处理格式转换；
• 适合少量配置项的注入，但不支持嵌套结构的批量映射，也无法使用@ConfigurationProperties的校验、绑定等高级特性。

额外注意 #

Azure App Config中的键/application/config.datasource.jdbc-url，Spring Boot会自动识别/application/为默认的应用环境前缀（当你的spring.application.name设为application时），因此实际参与绑定的键是config.datasource.jdbc-url，与本地配置文件的键格式一致。

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