在使用spring boot和thymeleaf进行表单开发时，开发者常会遇到`illegalstateexception: neither bindingresult nor plain target object for bean name ‘…’ available`的错误。此异常通常发生在thymeleaf模板尝试通过`th:object`绑定表单对象时，但该对象并未被正确地添加到模型中。解决此问题的关键在于确保在渲染表单的get请求中，将预期的表单对象实例注入到模型中，以便thymeleaf能够成功进行绑定。
Spring Boot与Thymeleaf表单绑定异常解析
在Spring Boot应用中，当您使用Thymeleaf作为模板引擎来处理表单时，可能会遇到一个常见的运行时错误：java.lang.IllegalStateException: Neither BindingResult nor plain target object for bean name ‘searchForm’ available as request attribute。这个错误通常伴随着org.thymeleaf.exceptions.TemplateProcessingException，并指向您的HTML模板中使用了th:object或th:field的行。
此异常的根本原因在于，当Thymeleaf模板（例如greeting.html）尝试通过th:object=”${searchForm}”绑定一个名为searchForm的对象时，Spring MVC的模型中并没有找到这个对象。th:object指令要求在渲染模板时，模型中必须存在一个与指定名称（在本例中是searchForm）对应的对象实例。如果缺失，Thymeleaf将无法完成其表单字段绑定操作，从而抛出IllegalStateException。
让我们通过一个具体的例子来理解这个问题。
错误代码示例
假设您有一个简单的搜索表单，包含一个输入字段：
greeting.html
Getting Started: Serving Web Content Hello!
以及一个用于承载表单数据的Java类：
SearchForm.java
package org.privatec.coogle;public class SearchForm { private String search; public String getSearch() { return search; } public void setSearch(String search) { this.search = search; }}
和一个Spring MVC控制器：
CoogleController.java (存在问题的版本)
package org.privatec.coogle.Controllers;import org.privatec.coogle.SearchForm;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.PostMapping;@Controllerpublic class PrivacoogleController { @GetMapping("/") public String greeting() { // 问题所在：没有将SearchForm添加到模型 return "greeting"; } @PostMapping("/") public void getPost(SearchForm searchForm) { System.out.println(searchForm.getSearch()); }}
当访问根路径（/）时，@GetMapping(“/”)方法被调用，它直接返回”greeting”视图名称。此时，greeting()方法没有将任何SearchForm的实例添加到Spring MVC的模型中。然而，greeting.html模板中的却期望模型中存在一个名为searchForm的对象。由于找不到，便会抛出上述IllegalStateException。
表单大师AI
一款基于自然语言处理技术的智能在线表单创建工具，可以帮助用户快速、高效地生成各类专业表单。
74 查看详情
解决方案
解决此问题的方法非常直接：在处理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注解@Controllerpublic 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请求时：
它会检测到SearchForm searchForm参数。由于该参数没有通过@RequestParam或@PathVariable等注解明确指定为请求参数或路径变量，Spring会将其视为一个模型属性。如果模型中不存在名为searchForm的属性，Spring会自动创建一个SearchForm的新实例，并将其添加到模型中，键名为”searchForm”（由@ModelAttribute注解指定）。如果省略@ModelAttribute(“searchForm”)，Spring会默认使用类名首字母小写作为键名，即”searchForm”。这样，当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表单应用的关键一步。
以上就是解决Spring Boot与Thymeleaf表单绑定中“对象不可用”的异常的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/312899.html
微信扫一扫 
支付宝扫一扫 
