@ModelAttribute 注解用于在控制器方法执行前自动填充模型，预加载导航菜单等公共数据；其方法默认以方法名小写为键存入Model，可显式指定键名，作用域限于本控制器，支持与表单绑定协同实现预设+补全逻辑。

@ModelAttribute 注解在 Spring MVC 中可用于在控制器方法执行前自动填充模型（Model），特别适合预加载跨多个请求的公用数据，比如导航菜单、用户信息、下拉选项等。它的核心机制是：带有 @ModelAttribute 的方法会在同控制器内所有 @RequestMapping 方法执行前被调用，并将其返回值或设置的属性添加到 Model 中。

全局预加载：用 @ModelAttribute 方法填充公共数据

在控制器类中定义一个无参（或仅含必要参数）的方法，加上 @ModelAttribute，Spring 会自动调用它并把返回值以“键=方法名”或指定名称存入 Model。

• 方法返回值不为 void 时，Spring 默认以方法名首字母小写作为 Model 属性名（如 initCommonData() → commonData）
• 可用 @ModelAttribute("menuList") 显式指定属性名，便于页面统一引用
• 该方法可调用 service 获取数据库数据（如菜单、字典项），但注意避免频繁查库，建议配合缓存

限定作用范围：只对特定控制器生效

@ModelAttribute 方法的作用域默认限于定义它的控制器类，不会影响其他 Controller。这意味着你可以为不同业务模块定制各自的预加载逻辑，互不干扰。

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

• 若需多个控制器共享相同预加载逻辑，可抽象出基类 Controller，让各子类继承
• 不推荐用 @ControllerAdvice + @ModelAttribute 全局预加载——除非真有全站级数据（如站点配置），否则易造成性能浪费和耦合
• 注意：@ModelAttribute 方法不能直接访问当前请求的路径变量或表单参数，如需动态数据，应通过 HttpServletRequest 或 ModelAttribute 参数间接获取

与表单绑定结合：同时支持预加载 + 数据绑定

@ModelAttribute 不仅能预加载，还能将请求参数绑定到对象上。当它标注在方法参数上时，表示从 Model 中取出对应属性；标注在方法上时，表示向 Model 中添加属性。

立即学习“Java免费学习笔记（深入）”；

• 例如：控制器中有 @ModelAttribute User user 参数，Spring 会先尝试从 Model 中找 user，找不到则 new 一个空实例再绑定请求参数
• 若你已在 @ModelAttribute 方法中放入了 user 实例（如从 session 取当前登录用户），后续方法就能直接使用这个已初始化的对象
• 注意区分：方法上的 @ModelAttribute 是“放数据”，参数上的 @ModelAttribute 是“取数据”，二者协同可实现“预设+补全”逻辑

常见误区与优化建议

实际使用中容易忽略生命周期和性能细节：

• 每个请求都会执行 @ModelAttribute 方法，不要在里面做耗时操作（如远程调用、复杂计算），应提前缓存结果
• 避免在 @ModelAttribute 方法中修改 request/session，它不是拦截器，职责应专注数据准备
• 如果预加载数据依赖当前用户权限，可在方法内注入 SecurityContext 或 Principal，但务必判空处理
• Thymeleaf 或 JSP 页面中直接用 ${menuList} 即可访问，无需额外 model.addAttribute()