@modelattribute 注解用于在控制器方法执行前自动填充模型，预加载导航菜单等公共数据；其方法默认以方法名小写为键存入model，可显式指定键名，作用域限于本控制器，支持与表单绑定协同实现预设+补全逻辑。
@ModelAttribute 注解在 Spring MVC 中可用于在控制器方法执行前自动填充模型（Model），特别适合预加载跨多个请求的公用数据，比如导航菜单、用户信息、下拉选项等。它的核心机制是：带有 @ModelAttribute 的方法会在同控制器内所有 @RequestMapping 方法执行前被调用，并将其返回值或设置的属性添加到 Model 中。
全局预加载：用 @ModelAttribute 方法填充公共数据
在控制器类中定义一个无参（或仅含必要参数）的方法，加上 @ModelAttribute，Spring 会自动调用它并把返回值以“键=方法名”或指定名称存入 Model。
- 方法返回值不为 void 时，Spring 默认以方法名首字母小写作为 Model 属性名（如
initCommonData()→commonData） - 可用
@ModelAttribute("menuList")显式指定属性名，便于页面统一引用 - 该方法可调用 service 获取数据库数据（如菜单、字典项），但注意避免频繁查库，建议配合缓存
限定作用范围：只对特定控制器生效
@ModelAttribute 方法的作用域默认限于定义它的控制器类，不会影响其他 Controller。这意味着你可以为不同业务模块定制各自的预加载逻辑，互不干扰。
- 若需多个控制器共享相同预加载逻辑，可抽象出基类 Controller，让各子类继承
- 不推荐用 @ControllerAdvice + @ModelAttribute 全局预加载——除非真有全站级数据（如站点配置），否则易造成性能浪费和耦合
- 注意：@ModelAttribute 方法不能直接访问当前请求的路径变量或表单参数，如需动态数据，应通过 HttpServletRequest 或 ModelAttribute 参数间接获取
与表单绑定结合：同时支持预加载 + 数据绑定
@ModelAttribute 不仅能预加载，还能将请求参数绑定到对象上。当它标注在方法参数上时，表示从 Model 中取出对应属性；标注在方法上时，表示向 Model 中添加属性。
- 例如：控制器中有
@ModelAttribute User user参数，Spring 会先尝试从 Model 中找user，找不到则 new 一个空实例再绑定请求参数 - 若你已在 @ModelAttribute 方法中放入了
user实例（如从 session 取当前登录用户），后续方法就能直接使用这个已初始化的对象 - 注意区分：方法上的 @ModelAttribute 是“放数据”，参数上的 @ModelAttribute 是“取数据”，二者协同可实现“预设+补全”逻辑
常见误区与优化建议
实际使用中容易忽略生命周期和性能细节：
- 每个请求都会执行 @ModelAttribute 方法，不要在里面做耗时操作（如远程调用、复杂计算），应提前缓存结果
- 避免在 @ModelAttribute 方法中修改 request/session，它不是拦截器，职责应专注数据准备
- 如果预加载数据依赖当前用户权限，可在方法内注入 SecurityContext 或 Principal，但务必判空处理
- Thymeleaf 或 JSP 页面中直接用
${menuList}即可访问，无需额外 model.addAttribute()
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
