Spring MVC表单提交List绑定时出现property path 'array[0]'索引越界异常

核心报错原因 #

Spring MVC 绑定表单中的列表类型属性时，有两个强制要求你的代码没有满足：

1. 表单类实例化后 filters 列表未初始化，值为 null，Spring 尝试操作列表索引时直接触发越界
2. 普通 List 实现类不支持自动扩容填充元素：如果列表的当前长度小于提交参数的索引值，Spring 不会自动创建空元素补全列表，会直接抛出索引越界异常

修复步骤 #

步骤1：使用Spring自带的AutoPopulatingList替代普通List作为filters的实现 #

AutoPopulatingList 是Spring工具包中专门为表单列表绑定设计的列表实现，访问超出当前长度的索引时会自动创建指定类型的空元素补全列表，完美适配表单列表绑定场景。
你需要在你的LoggingAnalysisFilteringForm（也就是继承AbstractAnalysisFilteringForm的子类）的无参构造中初始化filters：

import org.springframework.util.AutoPopulatingList;

// 假设你的过滤器实现类名为CustomLogFilter，替换为你实际的AbstractFilter子类名
public class LoggingAnalysisFilteringForm extends AbstractAnalysisFilteringForm<YourTType, CustomLogFilter> {
    public LoggingAnalysisFilteringForm() {
        // 初始化可自动填充元素的filters列表
        super.setFilters(new AutoPopulatingList<>(CustomLogFilter.class));
    }
}

注意：因为父类AbstractAnalysisFilteringForm中的filters是private修饰的，子类无法直接访问，所以通过父类提供的setFilters方法赋值即可。

步骤2：检查过滤器子类的无参构造 #

确保你的AbstractFilter子类（也就是上面的CustomLogFilter）保留无参构造方法，AutoPopulatingList需要通过无参构造自动创建元素实例，你当前的抽象父类已经定义了无参构造，只要子类没有主动删除无参构造就无需额外修改。

可选替代方案（适合固定数量的过滤器场景） #

如果你的页面上过滤器数量是固定的，不需要动态新增删除，也可以不用AutoPopulatingList，直接在表单类构造中预先创建对应数量的空过滤器元素即可：

public class LoggingAnalysisFilteringForm extends AbstractAnalysisFilteringForm<YourTType, CustomLogFilter> {
    public LoggingAnalysisFilteringForm() {
        List<CustomLogFilter> initFilters = new ArrayList<>();
        // 假设页面固定展示3个过滤器，预先填充3个空元素
        for (int i = 0; i < 3; i++) {
            initFilters.add(new CustomLogFilter());
        }
        super.setFilters(initFilters);
    }
}

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