如何通过EnvironmentPostProcessor完全替换Spring Boot列表配置属性？

Spring完全支持通过EnvironmentPostProcessor替换整个列表类型的配置属性，你当前的问题是因为采用了索引式的元素覆盖写法，导致原有列表未被完全替换，而是和新元素合并了。

问题原因 #

你之前的代码通过property[0]、property[1]这种索引键来设置值，这种方式只会修改原有列表对应位置的元素，不会删除列表中超出新元素数量的旧元素——Spring会自动合并新旧列表的元素，最终得到混合状态的列表。

正确实现方式 #

直接将完整的新列表作为属性值存入自定义属性源，而不是逐个设置索引项。这样高优先级的属性源会完全覆盖低优先级的同名列表属性，而非合并元素。

核心代码示例：

import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;
import org.springframework.core.env.MapPropertySource;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.boot.env.EnvironmentPostProcessor;

public class CustomEnvironmentPostProcessor implements EnvironmentPostProcessor {
    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, org.springframework.boot.SpringApplication application) {
        Map<String, Object> propertySource = new HashMap<>();
        // 直接存入完整的新列表
        propertySource.put("property", Arrays.asList("n1", "n2", "n3"));
        // 将自定义属性源添加到最前面，确保优先级最高
        environment.getPropertySources().addFirst(new MapPropertySource("override", propertySource));
    }
}

原理说明 #

Spring的属性解析机制中，当不同属性源存在同名属性时，优先级高的属性源会完全覆盖优先级低的属性。直接设置property对应的列表值，相当于用新的列表整体替换旧列表；而索引式写法只是修改旧列表的部分元素，原有列表的其他元素会被保留并合并。

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