Spring Boot 2.6.6读取外部YML配置文件失败求助

核心问题 #

• PropertySourcesPlaceholderConfigurer原生不支持YAML格式：该类仅针对.properties文件设计，直接加载YAML文件无法完成解析，导致配置不生效。
• 跨平台路径兼容问题：本地Windows环境下，类Unix路径/usr/IN/...会被转换为\usr\IN\...，若本地无对应目录则触发文件找不到错误。

可行解决方法 #

方法1：使用Spring Boot原生外部配置参数（推荐） #

无需编写自定义Bean，启动应用时通过参数指定外部YAML文件路径，Spring Boot会自动解析加载：

# 类Unix生产环境
java -jar your-application.jar --spring.config.location=file:/usr/IN/application-DEV.yml
# Windows本地测试环境
java -jar your-application.jar --spring.config.location=file:D:/usr/IN/application-DEV.yml

注：Spring Cloud Bootstrap环境下，需确保spring-cloud-starter-bootstrap依赖已正确引入，该参数会被bootstrap上下文优先读取。

方法2：自定义YAML解析的配置Bean #

若需通过代码逻辑加载，需借助YamlPropertySourceLoader实现YAML文件解析，替换默认的配置加载逻辑：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.PropertySource;
import org.springframework.core.io.FileSystemResource;
import org.springframework.core.io.support.DefaultPropertySourceFactory;
import org.springframework.core.io.support.EncodedResource;
import org.springframework.core.io.support.PropertySourceFactory;
import org.springframework.core.io.support.YamlPropertySourceLoader;
import org.springframework.context.support.PropertySourcesPlaceholderConfigurer;

import java.io.IOException;

@Configuration
public class ExternalConfigLoader {

    @Bean
    public static PropertySourcesPlaceholderConfigurer externalYamlConfig() {
        PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();
        // 设置自定义YAML解析工厂
        configurer.setPropertySourceFactory(new YamlPropertySourceFactory());
        configurer.setLocation(new FileSystemResource("/usr/IN/application-DEV.yml"));
        return configurer;
    }

    // 自定义YAML属性源工厂
    static class YamlPropertySourceFactory extends DefaultPropertySourceFactory {
        @Override
        public PropertySource<?> createPropertySource(String name, EncodedResource resource) throws IOException {
            if (resource == null) {
                return super.createPropertySource(name, resource);
            }
            // 加载并返回YAML解析后的属性源
            return new YamlPropertySourceLoader().load(
                resource.getResource().getFilename(), 
                resource.getResource()
            ).get(0);
        }
    }
}

本地测试路径适配 #

Windows本地测试时，需将路径调整为Windows格式（如D:/usr/IN/application-DEV.yml），或使用项目相对路径避免跨平台差异。

报错日志翻译：
导致原因：java.io.FileNotFoundException: \usr\IN\application-DEV.yml（系统找不到指定的路径）

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