Spring Boot 3.1.6：命令行参数覆盖深度嵌套配置属性异常排查

当你使用--cfg.array[0].some-key.sub-array[0]=valueX这种命令行参数时，Spring Boot默认会创建新对象替换数组索引0的原有元素，而非在原有对象上修改嵌套属性。这就导致原配置中ref-id、name等属性被重置为对应类型的默认值（Long类型默认0，String类型默认null）。

要保留原有配置并仅修改嵌套属性，需要让Spring Boot对数组元素启用属性合并而非替换。Spring Boot 3.1+提供了@Merge注解来实现这一需求，具体步骤如下：

1. 修正配置类结构并启用合并 #

确保你的配置类与YAML结构完全对应，并在数组元素的类上添加@Merge注解，告知Spring Boot绑定参数时合并原有对象的属性：

@ConfigurationProperties(prefix = "cfg")
@Configuration
public class AppConfig {
    private List<ArrayItem> array = new ArrayList<>();

    // Getter & Setter

    @Merge // 关键：开启该类的属性合并
    public static class ArrayItem {
        private Long refId;
        private String name;
        private SomeKey someKey;

        // Getter & Setter

        @Merge // 嵌套类同样启用合并（修改嵌套属性时需要）
        public static class SomeKey {
            private List<String> subArray = new ArrayList<>();

            // Getter & Setter
        }
    }
}

注意：字段名需遵循Spring Boot的宽松绑定规则，比如YAML中的ref-id对应类中的refId，some-key对应someKey，框架会自动处理连字符到驼峰的转换。

2. 保持原命令行参数不变 #

继续使用你原来的命令行启动命令即可：

java -jar app.jar --cfg.array[0].some-key.sub-array[0]=valueX

此时Spring Boot会在原有array[0]对象的基础上，仅修改sub-array[0]的值，保留ref-id和name的原始配置。

兼容低版本Spring Boot（低于3.1） #

如果你的Spring Boot版本低于3.1，可通过@ConfigurationProperties的merge属性开启全局合并，并调整集合合并策略：

@ConfigurationProperties(
    prefix = "cfg",
    merge = Merge.ENABLED,
    collectionMergeStrategy = CollectionMergeStrategy.REPLACE_BY_ADDING
)
@Configuration
public class AppConfig {
    // 类结构同上
}

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