Spring Boot中Thymeleaf表单绑定报错：无可用请求属性

错误原因分析 #

这个错误的核心是：Thymeleaf渲染account-create模板时，请求属性中找不到名为accountCreationRequestDto的对象或对应的BindingResult实例。通常发生在表单提交后，服务器端处理出现绑定/校验错误，但控制器未将对象重新放入模型就返回了表单视图。

解决方案 #

1. 为Post请求添加BindingResult参数并处理错误 #

修改@PostMapping方法，在AccountCreationRequestDto参数后紧跟BindingResult参数，用于捕获表单绑定或校验错误。若存在错误，将对象重新放入模型并返回表单页面：

@PostMapping("/create")
public String createAccount(@ModelAttribute("accountCreationRequestDto") AccountCreationRequestDto accountCreationRequestDto, 
                            BindingResult bindingResult, 
                            Model model) {
    // 检查是否有绑定/校验错误
    if (bindingResult.hasErrors()) {
        // 将对象放回模型，确保Thymeleaf能找到它
        model.addAttribute("accountCreationRequestDto", accountCreationRequestDto);
        return "account-create";
    }
    // 执行账户创建逻辑
    return "redirect:/success";
}

2. （可选）添加校验注解并启用校验 #

如果AccountCreationRequestDto使用了JSR-380校验注解（如@NotNull、@Size等），需在参数前添加@Valid注解，让Spring自动执行校验并将错误存入BindingResult：

@PostMapping("/create")
public String createAccount(@Valid @ModelAttribute("accountCreationRequestDto") AccountCreationRequestDto accountCreationRequestDto, 
                            BindingResult bindingResult, 
                            Model model) {
    if (bindingResult.hasErrors()) {
        model.addAttribute("accountCreationRequestDto", accountCreationRequestDto);
        return "account-create";
    }
    // 执行账户创建逻辑
    return "redirect:/success";
}

3. 确保参数顺序正确 #

注意：BindingResult参数必须紧跟在对应的@ModelAttribute参数之后，否则Spring无法将绑定错误与该对象关联，会直接抛出异常。

验证要点 #

• 表单提交后，若出现字段格式错误、校验失败等情况，控制器会回到account-create页面，且模型中存在accountCreationRequestDto对象，Thymeleaf能正常渲染表单并显示错误信息。
• 若账户创建成功，会重定向到/success页面，避免表单重复提交问题。

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