Java应用中如何将YAML配置文件的纯字符串端点替换为可从Java枚举导入的变量

这是个很常见的需求——不想在配置文件里硬编码端点字符串，而是把这些值集中管理在Java枚举里，避免重复、降低维护成本。假设你用的是Spring Boot（毕竟application.yaml是Spring Boot的标配），下面是几个实用的方案：

方案1：用@ConfigurationProperties直接绑定枚举默认值 #

这个方法最简单直接，不需要在YAML里写任何硬编码路径，而是在配置类里直接用枚举值作为默认属性。

首先定义你的端点枚举：

public enum KeycloakEndpoints {
    TOKEN_URI("path/to/somewhere"),
    AUTHORIZATION_URI("path/to/somewhere"),
    USERINFO_URI("path/to/somewhere");

    private final String uri;

    KeycloakEndpoints(String uri) {
        this.uri = uri;
    }

    public String getUri() {
        return uri;
    }
}

然后创建一个配置属性类，绑定到YAML的前缀，并把枚举值作为默认值：

@Configuration
@ConfigurationProperties(prefix = "security.oauth2.client.provider.keycloak")
public class KeycloakProviderProperties {
    // 直接用枚举值作为默认配置
    private String tokenUri = KeycloakEndpoints.TOKEN_URI.getUri();
    private String authorizationUri = KeycloakEndpoints.AUTHORIZATION_URI.getUri();
    private String userinfoUri = KeycloakEndpoints.USERINFO_URI.getUri();

    // 生成Getter和Setter
    public String getTokenUri() { return tokenUri; }
    public void setTokenUri(String tokenUri) { this.tokenUri = tokenUri; }
    public String getAuthorizationUri() { return authorizationUri; }
    public void setAuthorizationUri(String authorizationUri) { this.authorizationUri = authorizationUri; }
    public String getUserinfoUri() { return userinfoUri; }
    public void setUserinfoUri(String userinfoUri) { this.userinfoUri = userinfoUri; }
}

优点：代码结构清晰，配置逻辑集中在Java代码里；如果需要临时覆盖某个端点，依然可以在YAML里写对应属性（YAML配置会覆盖默认值）。

方案2：把枚举值暴露为Spring环境属性，用占位符引用 #

如果你希望保留YAML的配置结构，只是不想写硬编码路径，可以把枚举值注册为Spring环境的属性，然后在YAML里用${}占位符引用。

首先还是定义好你的KeycloakEndpoints枚举，然后创建一个配置类来注册这些属性：

@Configuration
public class EndpointPropertyRegistrar {
    @Bean
    public static PropertySourcesPlaceholderConfigurer endpointPropertyConfigurer() {
        PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();
        Properties properties = new Properties();

        // 把枚举值映射为Spring属性
        properties.setProperty("keycloak.endpoints.token-uri", KeycloakEndpoints.TOKEN_URI.getUri());
        properties.setProperty("keycloak.endpoints.authorization-uri", KeycloakEndpoints.AUTHORIZATION_URI.getUri());
        properties.setProperty("keycloak.endpoints.userinfo-uri", KeycloakEndpoints.USERINFO_URI.getUri());

        configurer.setProperties(properties);
        return configurer;
    }
}

然后在application.yaml里就可以用占位符代替硬编码路径：

security:
  oauth2:
    client:
      provider:
        keycloak:
          token-uri: ${keycloak.endpoints.token-uri}
          authorization-uri: ${keycloak.endpoints.authorization-uri}
          userinfo-uri: ${keycloak.endpoints.userinfo-uri}

优点：YAML结构清晰，一眼能看到配置的关联关系；枚举值可以在多个配置文件或代码中复用。

方案3：用EnvironmentPostProcessor自动注入枚举值 #

这个方案最灵活，适合需要在应用启动时自动把所有枚举端点加载到Spring环境的场景，甚至不需要在YAML里写任何配置（Spring会自动绑定环境中的属性）。

首先定义枚举，然后实现EnvironmentPostProcessor接口：

public class KeycloakEndpointEnvironmentPostProcessor implements EnvironmentPostProcessor {
    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        // 把枚举值转换为Spring环境属性，键名和YAML的配置路径完全对应
        Map<String, Object> endpointProperties = new HashMap<>();
        for (KeycloakEndpoints endpoint : KeycloakEndpoints.values()) {
            // 把枚举名称转换为YAML风格的小写连字符格式
            String propertyKey = "security.oauth2.client.provider.keycloak." + 
                endpoint.name().toLowerCase().replace("_", "-");
            endpointProperties.put(propertyKey, endpoint.getUri());
        }

        // 把属性添加到Spring环境中
        environment.getPropertySources().addLast(new MapPropertySource("keycloak-endpoints", endpointProperties));
    }
}

最后需要在src/main/resources/META-INF/spring.factories里注册这个处理器：

org.springframework.boot.env.EnvironmentPostProcessor=com.yourpackage.KeycloakEndpointEnvironmentPostProcessor

这样操作后，Spring启动时会自动把枚举里的端点值加载到环境中，你甚至可以不用在YAML里配置这些token-uri等属性——Spring会自动绑定环境中的值。如果需要覆盖某个端点，直接在YAML里写对应属性即可（YAML的优先级更高）。

优点：完全自动化，不需要手动维护YAML和枚举的关联；适合大规模、多环境的配置场景。

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