Thymeleaf 3标签无法向服务器返回值，Spring Boot v1数据回传求助

嘿，我之前在做类似项目的时候也踩过这个数据回传的坑，咱们一步步拆解问题，把它搞定：

1. 先确认表单的Thymeleaf绑定是否正确 #

这是最容易出错的地方，你得确保整个表单和Person对象绑定，并且每个字段都用正确的表达式关联属性：

• 表单标签必须用 th:object="${person}" 绑定控制器传过来的Person对象
• 表单字段用 th:field="*{属性名}" 来绑定，嵌套对象的话就用 *{嵌套对象.属性} 的格式

举个完整的表单例子：

<form th:object="${person}" method="post" action="/save-person">
  <!-- 绑定需要回传的formValue1 -->
  <div>
    <label>表单值1：</label>
    <input type="text" th:field="*{formValue1}" />
  </div>

  <!-- 绑定嵌套Address的属性（比如街道） -->
  <div>
    <label>街道：</label>
    <input type="text" th:field="*{address.street}" />
  </div>

  <!-- 如果有不需要用户修改但要保留的嵌套对象属性（比如Job的ID），用hidden字段存起来 -->
  <input type="hidden" th:field="*{job.id}" />

  <button type="submit">提交</button>
</form>

2. 控制器接收参数的姿势要对 #

在处理POST请求的控制器方法里，必须用 @ModelAttribute 注解来接收Person对象，Spring MVC才会自动把表单数据绑定到对象上：

@PostMapping("/save-person")
public String savePerson(@ModelAttribute Person person) {
  // 这里就能拿到回传的formValue1，以及嵌套对象的更新值了
  System.out.println("回传的formValue1：" + person.getFormValue1());
  System.out.println("回传的街道：" + person.getAddress().getStreet());
  return "success-page";
}

3. 务必初始化嵌套对象！ #

这是很多人忽略的点：如果控制器传到页面的Person对象里，Address或Job是null，Thymeleaf没法在页面上绑定嵌套属性，而且Spring MVC回传时也没法自动实例化这些嵌套对象，导致数据丢失。

所以在控制器渲染页面的时候，要提前初始化嵌套对象：

@GetMapping("/edit-person")
public String showEditForm(Model model) {
  Person person = new Person();
  // 初始化嵌套对象，避免null导致绑定失败
  person.setAddress(new Address());
  person.setJob(new Job());
  
  // 这里给嵌套对象设置从数据源获取的初始值
  person.getAddress().setStreet("中关村大街");
  person.getJob().setId(1001);
  
  model.addAttribute("person", person);
  return "edit-form";
}

4. 检查所有属性的Getter/Setter是否齐全 #

Spring MVC和Thymeleaf都是通过Getter读取属性、Setter设置属性的，所以Person、Address、Job里的所有需要绑定的属性，必须有对应的Getter和Setter方法。比如：

• Person类要有getFormValue1()、setFormValue1(String)，getAddress()、setAddress(Address)
• Address类要有getStreet()、setStreet(String)
• Job类要有getId()、setId(Integer)

如果漏了某个Setter，对应的属性就没法回传到控制器里。

5. 排查自定义WebMvc配置的影响 #

如果你自定义了WebMvcConfigurer，要确保没有覆盖initBinder或者addFormatters方法导致数据绑定失效。Spring Boot v1默认已经开启了自动数据绑定，除非你自己改了配置，一般不会有这个问题。

按照上面的步骤排查下来，基本就能解决数据回传的问题了，我当时就是因为没初始化嵌套对象，折腾了好半天😂

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