Spring表单绑定POJO关联类时出现400错误求助

我之前也碰到过一模一样的问题！这种动态添加行绑定集合的场景，Spring MVC默认的集合处理逻辑确实容易踩坑，我来给你梳理下问题根源和具体解决办法：

问题原因 #

Spring MVC在绑定集合类型的属性时，默认要求集合中已经存在对应索引的元素实例。你动态添加行时，比如新增了tourDetails[1].departDate这样的字段，但后台的EmployeeTourPojo里的tourDetails列表可能只有初始的0号元素（甚至是空的），Spring找不到索引1对应的TourDetailsPojo实例，就会抛出绑定错误，直接返回400 Bad Request。

另外还有一个潜在坑：departDate是Date类型，如果前端提交的日期字符串和Spring默认的解析格式不匹配，也会触发绑定失败。

具体解决步骤 #

1. 用AutoPopulatingList替代普通ArrayList #

Spring提供了AutoPopulatingList，它会在访问超出当前列表大小的索引时，自动实例化对应的元素，完美解决动态添加行的绑定问题。

修改EmployeeTourPojo：

import org.springframework.util.AutoPopulatingList;

public class EmployeeTourPojo { 
    private String empDisplayName; 
    private AutoPopulatingList<TourDetailsPojo> tourDetails; 

    // 构造方法里初始化AutoPopulatingList，指定要实例化的元素类型
    public EmployeeTourPojo() {
        tourDetails = new AutoPopulatingList<>(TourDetailsPojo.class);
    }

    // 生成对应的getter和setter
    public String getEmpDisplayName() {
        return empDisplayName;
    }

    public void setEmpDisplayName(String empDisplayName) {
        this.empDisplayName = empDisplayName;
    }

    public AutoPopulatingList<TourDetailsPojo> getTourDetails() {
        return tourDetails;
    }

    public void setTourDetails(AutoPopulatingList<TourDetailsPojo> tourDetails) {
        this.tourDetails = tourDetails;
    }
}

2. 配置日期格式解析 #

因为departDate是Date类型，需要告诉Spring如何解析前端提交的日期字符串，有两种方式：

方式一：在实体类字段上加注解

修改TourDetailsPojo，根据你的datepicker格式调整pattern：

import org.springframework.format.annotation.DateTimeFormat;
import java.util.Date;

public class TourDetailsPojo { 
    @DateTimeFormat(pattern = "yyyy-MM-dd") // 比如你的datepicker用的是年-月-日格式
    private Date departDate; 
    private String departTime; 

    // getter和setter
}

方式二：在Controller里用@InitBinder配置

如果不想修改实体类，可以在处理表单的Controller里添加：

import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.annotation.InitBinder;
import java.text.SimpleDateFormat;
import org.springframework.beans.propertyeditors.CustomDateEditor;

@InitBinder
public void initBinder(WebDataBinder binder) {
    SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
    dateFormat.setLenient(false); // 严格校验日期格式
    // 第二个参数true表示允许空值
    binder.registerCustomEditor(Date.class, new CustomDateEditor(dateFormat, true));
}

3. 确保前端动态添加的索引连续 #

动态添加行时，要保证索引是连续递增的（比如0、1、2...），这样AutoPopulatingList才能正确创建对应实例。举个JavaScript示例：

// 初始索引从1开始，假设页面加载时已经有一行索引0
let currentIndex = 1;

function addNewTourRow() {
    // 动态生成表单行，注意path里的索引
    const newRow = `
        <tr>
            <td>
                <input type="text" name="tourDetails[${currentIndex}].departDate" 
                       class="datepicker form-control" required="required"
                       placeholder="Departure Date">
            </td>
            <td>
                <input type="text" name="tourDetails[${currentIndex}].departTime" 
                       class="form-control" placeholder="Departure Time">
            </td>
        </tr>
    `;
    // 把新行添加到表格里
    document.getElementById("tour-table-body").insertAdjacentHTML('beforeend', newRow);
    // 重新初始化datepicker（如果用了日期插件）
    $('.datepicker').datepicker();
    currentIndex++;
}

4. 控制器里初始化模型对象 #

在展示表单的GET方法里，要把EmployeeTourPojo实例放到模型中，确保表单能正确绑定：

import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@GetMapping("/tour-form")
public String showTourForm(Model model) {
    // 初始化模型对象，AutoPopulatingList会自动创建第一个空实例
    model.addAttribute("employeeTour", new EmployeeTourPojo());
    return "tour-form";
}

验证提交 #

最后，在POST方法里接收绑定好的对象即可：

import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.PostMapping;

@PostMapping("/submit-tour")
public String submitTourForm(@ModelAttribute("employeeTour") EmployeeTourPojo tourPojo, BindingResult result) {
    // 先校验绑定错误
    if (result.hasErrors()) {
        return "tour-form";
    }
    // 处理你的业务逻辑，比如保存到数据库
    return "success-page";
}

这样修改后，动态添加的行就能正确绑定到后台的集合里，不会再出现400错误了。

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