Spring Boot控制器无法绑定Thymeleaf UI表单值问题

嘿，我来帮你搞定这个Thymeleaf表单绑定后控制器输出null的问题！这种情况我碰到过好多次，大概率是这几个细节没处理对，咱们一步步排查：

1. 先检查表单的基础配置是否正确 #

首先，你的表单得有正确的提交地址和请求方法，而且输入框的name属性必须和控制器接收的参数名完全匹配（大小写都不能错！）。

举个例子，如果你的控制器代码是这样的：

@PostMapping("/greet")
public String handleGreeting(@RequestParam("username") String username) {
    System.out.println(username); // 这里输出null的话，先看input的name
    return "index";
}

那对应的HTML表单得这么写：

<form th:action="@{/greet}" method="post">
    <label>用户名：</label>
    <input type="text" name="username" placeholder="输入你的名字"/>
    <button type="submit">提交</button>
</form>

要是你漏写了name属性，或者名字和控制器参数不一样，Spring根本找不到要绑定的值，自然就输出null了。

2. 用实体类接收参数？检查构造器和getter/setter #

如果是用实体类来接收表单数据，比如定义了一个User类：

public class User {
    private String username;
    
    // 必须要有公开的无参构造器！Spring需要用它实例化对象
    public User() {}
    
    // 必须要有对应的getter和setter方法，不然Spring没法给字段赋值
    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }
}

控制器方法是：

@PostMapping("/greet")
public String handleGreeting(User user) {
    System.out.println(user.getUsername());
    return "index";
}

那HTML里的输入框name必须和实体类的字段名一致（比如name="username"），而且一定要确保实体类有无参构造器和完整的getter/setter——这俩是很多人容易忽略的点！

3. 试试Thymeleaf推荐的绑定方式（更不容易出错） #

Thymeleaf提供了th:object和th:field的绑定方式，能自动生成正确的name属性，避免手动写错。比如：

<form th:action="@{/greet}" method="post" th:object="${user}">
    <label>用户名：</label>
    <input type="text" th:field="*{username}" placeholder="输入你的名字"/>
    <button type="submit">提交</button>
</form>

这种方式下，Thymeleaf会自动给input加上name="username"，还能帮你回显值，比手动写name靠谱多了。记得要在控制器里先把user对象放到Model里，比如：

@GetMapping("/")
public String showForm(Model model) {
    model.addAttribute("user", new User());
    return "index";
}

4. 检查请求方法是否匹配 #

如果控制器用的是@PostMapping，那表单的method必须是post；要是用@GetMapping，表单method就得是get（不过表单提交一般用post更合适）。请求方法不匹配的话，参数也没法正确绑定。

5. 排除其他小问题 #

比如有没有JavaScript代码不小心清空了输入框的值？或者参数是特殊类型（比如日期）需要额外配置转换器？不过如果是普通字符串的话，一般不会有这种问题。

要是你能把完整的表单代码和控制器代码贴出来，我能帮你更精准地定位问题，但先从上面这几点排查，大概率能解决null的问题！

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