@PropertySource读取环境变量路径在Windows系统失效问题

这个问题我在跨平台开发Spring Boot应用时碰到过好几次，核心原因是Windows环境变量的解析逻辑和Linux略有差异，再加上@PropertySource默认的占位符处理方式容易踩坑，给你几个经过验证的解决方案：

方案1：修正@PropertySource的环境变量引用格式 #

你之前写的@PropertySource("file:${env.variable.name}/file.properties")里的env.前缀是多余的——Spring的${}占位符会直接读取系统环境变量，不需要额外前缀。正确的写法应该直接引用环境变量名：

@Configuration
@PropertySource("file:${PROPS}/file.properties")
public class ExternalConfig {
    // 配置Bean定义
}

注意事项： #

• Windows下配置环境变量PROPS时，路径可以用/作为分隔符（比如C:/usr/local/config），Spring会自动适配成Windows的\格式；
• 环境变量修改后必须重启IDE或命令提示符，否则当前进程无法读取到新的环境变量值；
• 如果路径包含空格，比如C:/Program Files/config，直接写${PROPS}即可，Spring会自动处理带空格的路径。

方案2：编程式加载配置（最可靠的跨平台方案） #

如果方案1仍然有问题，可能是@PropertySource的占位符解析时机导致的（比如在Spring环境初始化前就解析了占位符），这时候用编程式加载配置更稳妥：

@Configuration
public class ExternalConfig implements EnvironmentAware {

    @Override
    public void setEnvironment(Environment environment) {
        // 直接从环境变量获取配置路径
        String propsBasePath = environment.getProperty("PROPS");
        if (propsBasePath == null) {
            throw new IllegalArgumentException("环境变量PROPS未配置");
        }

        // 构建配置文件路径，跨平台自动适配分隔符
        Path configFile = Paths.get(propsBasePath, "file.properties");
        FileSystemResource resource = new FileSystemResource(configFile.toFile());

        // 加载并添加到Spring环境中
        try (InputStream is = resource.getInputStream()) {
            Properties props = new Properties();
            props.load(is);
            MutablePropertySources propertySources = ((ConfigurableEnvironment) environment).getPropertySources();
            // 优先加载外部配置，覆盖默认配置
            propertySources.addFirst(new PropertiesPropertySource("external-config", props));
        } catch (IOException e) {
            throw new RuntimeException("加载外部配置文件失败: " + configFile, e);
        }
    }
}

这种方式直接通过Spring的Environment获取环境变量，手动加载配置文件，完全规避了@PropertySource的占位符解析问题，Windows和Linux下都能稳定运行。

方案3：利用Spring Boot原生外部配置特性（推荐） #

其实Spring Boot本身就支持通过环境变量指定外部配置文件路径，不需要手动写@PropertySource，更符合框架的最佳实践：

• Linux环境：执行export SPRING_CONFIG_LOCATION=file:${PROPS}/file.properties，然后启动应用；
• Windows环境：在系统环境变量中添加SPRING_CONFIG_LOCATION，值设为file:${PROPS}/file.properties（或者直接写绝对路径file:C:/usr/local/config/file.properties）；

Spring Boot启动时会自动加载这个路径下的配置文件，还支持同时加载多个配置，比如SPRING_CONFIG_LOCATION=file:${PROPS}/file.properties,file:${PROPS}/other.properties。

额外提示 #

如果只是需要加载补充配置，而非覆盖默认配置，可以用SPRING_CONFIG_ADDITIONAL_LOCATION环境变量，它会在默认配置之后加载，不会覆盖默认配置项。

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