Spring Boot中Thymeleaf的th:field属性报错原因及解决方法

错误原因 #

• 视图层缺少绑定对象：访问首页/返回表单页面时，没有向视图中注入表单绑定需要的user对象，导致Thymeleaf解析th:object="${user}"时找不到对应属性，触发th:field相关报错。
• 实体类Getter/Setter缺失：若你没有实际实现UserEntity中属性对应的get、set方法，Thymeleaf无法通过反射读写name、email字段，也会引发该错误。

具体修复步骤 #

1. 修正UserController的首页接口，注入绑定对象
   修改welcome方法代码如下：

@RequestMapping("/")
public ModelAndView welcome() {
    ModelAndView modelAndView = new ModelAndView();
    // 新增：注入空的UserEntity对象供表单绑定
    modelAndView.addObject("user", new UserEntity());
    modelAndView.setViewName("form");
    return modelAndView;
}

2. 补全UserEntity的Getter和Setter方法
   在UserEntity类中添加以下代码：

// id的get/set方法
public Integer getId() {
    return id;
}
public void setId(Integer id) {
    this.id = id;
}

// name的get/set方法
public String getName() {
    return name;
}
public void setName(String name) {
    this.name = name;
}

// email的get/set方法
public String getEmail() {
    return email;
}
public void setEmail(String email) {
    this.email = email;
}

可选优化（适配表单绑定逻辑） #

你当前的Post接口使用@RequestParam逐个接收参数，可改为直接接收绑定后的实体对象，简化代码：

@PostMapping("/add")
@ResponseBody
public String addNewUser(@ModelAttribute("user") UserEntity newUser)
{
    userRepository.save(newUser);
    return "User Created";
}

内容的提问来源于stack exchange，提问作者Berke Şentürk