解决Spring Boot与Thymeleaf表单绑定中“对象不可用”的异常

解决方案

解决此问题的方法非常直接：在处理GET请求的方法中，确保将表单对象的一个实例添加到模型中。Spring MVC提供了便捷的方式来完成这一点。

CoogleController.java (修正后的版本)

package org.privatec.coogle.Controllers;

import org.privatec.coogle.SearchForm;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model; // 导入Model接口，如果需要手动添加属性
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.ModelAttribute; // 导入ModelAttribute注解

@Controller
public class PrivacoogleController {

    @GetMapping("/")
    public String greeting(@ModelAttribute("searchForm") SearchForm searchForm) {
        // Spring MVC会自动创建一个SearchForm实例并将其添加到模型中，
        // 键名为"searchForm"（由@ModelAttribute指定）。
        // 如果没有@ModelAttribute，Spring也会尝试以类名首字母小写作为键名添加。
        return "greeting";
    }

    @PostMapping("/")
    public String getPost(@ModelAttribute("searchForm") SearchForm searchForm) {
        System.out.println("Submitted search term: " + searchForm.getSearch());
        // 处理表单提交逻辑，例如保存数据、重定向等
        // 这里只是简单打印，实际应用中可能需要返回一个视图或重定向
        return "redirect:/"; // 示例：处理完后重定向回首页
    }

}

在修正后的greeting方法中，我们添加了一个参数@ModelAttribute("searchForm") SearchForm searchForm。当Spring MVC处理这个GET请求时：

1. 它会检测到SearchForm searchForm参数。
2. 由于该参数没有通过@RequestParam或@PathVariable等注解明确指定为请求参数或路径变量，Spring会将其视为一个模型属性。
3. 如果模型中不存在名为searchForm的属性，Spring会自动创建一个SearchForm的新实例，并将其添加到模型中，键名为"searchForm"（由@ModelAttribute注解指定）。如果省略@ModelAttribute("searchForm")，Spring会默认使用类名首字母小写作为键名，即"searchForm"。
4. 这样，当greeting.html模板被渲染时，th:object="${searchForm}"就能成功找到对应的对象，从而避免了IllegalStateException。

注意事项与最佳实践

• @ModelAttribute的用途： @ModelAttribute注解不仅用于将请求参数绑定到Java对象，还可以用于在方法参数上声明一个模型属性。当它用于方法参数时，Spring会尝试从模型中查找该对象；如果找不到，它会创建一个新实例并添加到模型中。

• 表单验证： 在实际的表单处理中，通常还需要进行表单验证。您可以在SearchForm类中使用JSR 303/380（Bean Validation）注解来定义验证规则，并在控制器方法参数中使用@Valid注解，紧随其后添加BindingResult参数来捕获验证结果：

  // 在SearchForm.java中添加验证注解
  import javax.validation.constraints.Size;
  
  public class SearchForm {
      @Size(min = 1, max = 50, message = "Search term must be between 1 and 50 characters")
      private String search;
      // ... getters and setters ...
  }
  
  // 在CoogleController.java中处理验证
  import org.springframework.validation.BindingResult;
  import javax.validation.Valid;
  
  @PostMapping("/")
  public String getPost(@Valid @ModelAttribute("searchForm") SearchForm searchForm, BindingResult bindingResult) {
      if (bindingResult.hasErrors()) {
          // 如果有错误，返回到表单页面重新显示错误信息
          return "greeting"; 
      }
      System.out.println("Submitted search term: " + searchForm.getSearch());
      return "redirect:/"; 
  }

  登录后复制

  在greeting.html中，您可以使用th:errors="*{search}"来显示特定字段的错误信息。

• POST请求中的@ModelAttribute： 在POST请求中，@ModelAttribute同样重要。它指示Spring从请求参数中填充SearchForm对象。如果该方法也需要处理验证，则应如上所示添加@Valid和BindingResult。

• 统一表单对象： 尽量在GET和POST方法中都使用相同的@ModelAttribute名称（例如"searchForm"），以保持代码的一致性和可读性。

总结

IllegalStateException: Neither BindingResult nor plain target object for bean name '...' available错误是Spring Boot与Thymeleaf表单绑定中一个常见的陷阱，其核心原因在于渲染表单的GET请求没有将所需的表单对象添加到模型中。通过在@GetMapping方法中声明@ModelAttribute参数，Spring MVC能够自动创建并注入表单对象到模型，从而顺利完成Thymeleaf的表单绑定。理解并正确应用@ModelAttribute是构建健壮的Spring Boot表单应用的关键一步。