Spring Boot 2.7.4无法读取外部文件中的占位符属性（Zulu11）

使用Spring Boot 2.7.4（JDK为Zulu11）时，遇到以下问题：application.yml中配置了my-sample-app.props.url: ${external_url}，外部文件external-service.properties定义了external_url = http://domain/external-app/dates，通过@PropertySources引入外部文件并使用@ConfigurationProperties绑定属性，但最终无法读取到正确的url值。

相关代码与项目结构 #

启动类 MysampleApp.java #

@SpringBootApplication
@EnableAutoConfiguration(exclude = {WebMvcAutoConfiguration.class })
@ComponentScan("com.test.example")
@PropertySources({ 
@PropertySource(value = "file:/Users/myuserid/external-service.properties")
})
public class MysampleApp {
    public static void main(String[] args) {
        SpringApplication.run(MysampleApp.class, args);
    }
}

项目结构 #

MySampleApp
--- src
----- main
------- resources
--------- config
----------- application.yml
----------- application-dev.yml

配置属性绑定类 ExternalServicePropConfig.java #

@Component
@ConfigurationProperties(prefix = "my-sample-app.props")
@Data
public class ExternalServicePropConfig
{
   private String url;
}

问题原因及解决办法 #

核心原因：配置加载顺序问题 #

@PropertySource注解加载外部配置的时机晚于Spring Boot解析application.yml的时机，导致yml中的${external_url}占位符无法被外部配置中的值替换，最终读取到的是占位符字符串本身而非目标值。

解决办法1：自定义EnvironmentPostProcessor提前加载外部配置 #

通过实现EnvironmentPostProcessor，在Spring环境初始化的早期阶段加载外部配置，确保yml解析时能获取到外部属性：

1. 创建处理器类：

package com.test.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.env.EnvironmentPostProcessor;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.PropertiesPropertySource;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.Properties;

public class ExternalConfigPostProcessor implements EnvironmentPostProcessor {
    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        var configPath = Paths.get("/Users/myuserid/external-service.properties");
        if (Files.exists(configPath)) {
            var properties = new Properties();
            try (var inputStream = Files.newInputStream(configPath)) {
                properties.load(inputStream);
                // 将外部配置添加到属性源最前面，确保优先级最高
                environment.getPropertySources().addFirst(new PropertiesPropertySource("external-service", properties));
            } catch (IOException e) {
                throw new RuntimeException("加载外部配置文件失败", e);
            }
        }
    }
}

2. 在src/main/resources/META-INF/spring.factories中注册处理器：

org.springframework.boot.env.EnvironmentPostProcessor=com.test.example.ExternalConfigPostProcessor

解决办法2：检查路径与编码问题 #

• 确保外部文件路径绝对正确：Mac/Linux系统路径大小写敏感，Windows系统注意转义符（比如用\\代替\）
• 若文件包含特殊字符，可在@PropertySource中指定编码：

@PropertySource(value = "file:/Users/myuserid/external-service.properties", encoding = "UTF-8")

解决办法3：确认激活的Profile正确 #

如果application-dev.yml是dev环境专属配置，需确保启动时激活了dev Profile：

• 启动命令添加参数：--spring.profiles.active=dev
• 或在application.yml中配置：

spring:
  profiles:
    active: dev

验证配置加载状态 #

可以在启动类中注入Environment，打印属性值验证是否加载成功：

@Autowired
private Environment env;

@PostConstruct
public void verifyProperties() {
    System.out.println("external_url 加载值: " + env.getProperty("external_url"));
    System.out.println("最终绑定的url值: " + env.getProperty("my-sample-app.props.url"));
}

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