Spring MVC 中 @ModelAttribute 注解的绑定机制详解

在Spring MVC开发中，`@ModelAttribute`是一个让人又爱又恨的注解。说它好用，是因为它能把表单数据和后台模型对象无缝对接；说它坑，是因为一旦用不好，你精心预设的默认值很可能被“无情覆盖”。

比如你遇到的情况：表单提交后，打印出来的对象全是用户刚刚填写的值，而不是你之前准备好的那个叫“zeus”的默认账户。先别急着怀疑是Bug，这其实是Spring的绑定机制在严格按规矩办事，这个规矩就是：名称匹配优先，请求参数说了算。

核心机制：数据绑定的三步走

当Spring处理一个带有 @ModelAttribute("zeus") Account u 参数的POST请求时，它到底干了些什么？我们来把流程拆解一下：

1. 先找对象：Spring会先去模型（Model）里翻一翻，看看有没有一个叫“zeus”的Account实例。你的addAccount()方法确实往Model里丢了一个，所以理论上是能找到的。
2. 找不到就新建：如果找不到（这在某些流程控制不严谨的场景下会发生），那Spring就自己 new 一个出来。
3. 关键转折点——表单参数覆盖一切：但这里有个至关重要的细节。Spring发现请求里确实传来了 username 和 password 参数，并且当前绑定的目标“zeus”和你的表单标签 modelAttribute="user1" 名字不匹配，这就会导致一个严重的连锁反应：Spring会直接忽略Model里那个叫“zeus”的对象，然后创建一个全新的、空的Account实例，并把表单里的两个字段直接绑定到这个新对象上。

问题就出在这里。解决方式其实很简单：保证所有用到这个名字的地方完全统一，一个字母都不能差。

正确做法一览

先把JSP页面的表单改掉：

    User: 

    Pass: 

    

控制器这边保持不动：

@RequestMapping(method = RequestMethod.POST, value = "/login")
public String checkLog(@ModelAttribute("zeus") Account u) {
    System.out.println(u); // 输出：User{username=表单输入, password=表单输入}
    return "hello";
}

@ModelAttribute
public void addAccount(Model model) {
    Account a = new Account();
    a.setUsername("zeus");   // 默认值，仅当表单未提交对应字段时生效
    a.setPassword("123");
    model.addAttribute("zeus", a);
}

现在，一切就对上了。Spring会找到Model里那个叫“zeus”的实例，然后只把你提交了表单字段（比如username和password）用你填写的新值覆盖掉，其他字段就还是“zeus”里的默认值。这才是我们想要的效果。

几个容易翻车的细节

• 名字必须一个字不差，大小写敏感：JSP表单的 modelAttribute="X"，Controller方法的 @ModelAttribute("X")，以及你在方法里 model.addAttribute("X", obj)，这三个地方的X必须完全一致。
• `@ModelAttribute`方法是个好帮手，但不是保险箱：它确实会在每个请求处理前先执行一遍，用来给Model放一些通用数据。但记住，它放进去的东西可以被后续的表单绑定“覆盖”掉。
• 空字段怎么处理？：如果你的表单只提交了 username，那 password 就还是默认值；如果它也提交了，那就被覆盖。逻辑很清楚，但在实际项目中要特别注意，特别是当你需要区分“用户没填写”和“用户故意留空”这两种情况时。
• 一个更直观的玩法：对于纯粹的、必须由用户填写的表单，我个人更推荐在Controller的GET方法里直接 model.addAttribute("zeus", new Account())。这样更直接，逻辑也更清晰，不容易和`@ModelAttribute`方法的执行时机搞混。
• 调试小技巧：要是真的搞不清楚到底哪个对象被绑定了，可以在你的处理方法里打印一下 model.asMap().keySet()，看看Model里实际存放了哪些属性名，一清二楚。

一句话总结

记住，`@ModelAttribute`不是个“静态模板”，它是个“动态绑定协议”。它只负责告诉你“我要绑定到这个模型的这个属性上”，而真正决定对象值的是HTTP请求里那些实实在在的参数。只要参数名和对象属性名能对得上，Spring就会用新的值去覆写，不管你这个对象是从哪来的。理解了这一点，你就真正掌握了Spring MVC表单处理的核心。