spring boot 处理表单参数主要依赖 @requestparam 注解或自动绑定到 dto 对象。对于简单的键值对,直接在控制器方法参数前加 @requestparam 即可获取;对于结构化的表单数据,定义一个包含对应字段的类并使用 @modelattribute(默认行为)或直接作为方法参数,框架会自动将请求体中的字段映射到对象属性上。

@RequestParam 如何解析单个表单字段
当使用 @RequestParam 时,Spring MVC 会根据参数名从请求的查询字符串或表单正文中提取对应的值。如果表单提交的是 application/x-www-form-urlencoded 类型,框架会解析键值对并匹配参数名。若未提供该参数且注解中未设置 required = false,则会抛出异常。

package com.example.demo;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.RestController;@RestControllerpublic class FormController { @PostMapping("/simple") public String handleSimple(@RequestParam String username, @RequestParam(required = false) Integer age) { return "User: " + username + ", Age: " + (age != null ? age : "N/A"); }}
预期结果:发送 POST 请求至 /simple,携带表单数据 username=test&age=25,返回 User: test, Age: 25。若省略 age,返回 User: test, Age: N/A。若省略 username,服务器返回 400 Bad Request。
@ModelAttribute 如何绑定复杂表单对象
对于包含多个字段的表单,定义一个 POJO 类并在控制器方法中使用该类的实例作为参数。Spring 会自动根据表单字段的名称与对象属性的 getter/setter 进行匹配。这种方式避免了逐个声明参数的繁琐,且天然支持嵌套对象和集合类型的绑定。

package com.example.demo;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RestController;public class UserForm { private String name; private String email; // getters and setters}@RestControllerpublic class FormController { @PostMapping("/complex") public String handleComplex(UserForm form) { return "Name: " + form.getName() + ", Email: " + form.getEmail(); }}
预期结果:发送 POST 请求至 /complex,携带表单数据 name=Alice&email=alice@example.com,返回 Name: Alice, Email: alice@example.com。若表单中缺少 email 字段,则 form.getEmail() 返回 null。
表单提交时如何处理日期类型参数
在 Spring Boot 中,如果表单中包含日期字段(如 yyyy-MM-dd 格式),直接绑定到 java.util.Date 或 LocalDate 可能会因为默认格式不匹配而失败。需要配置全局格式化器或使用 @DateTimeFormat 注解来指定解析模式,否则框架无法将字符串转换为日期对象。











