Spring Boot接口接收form-data时title参数未识别问题求助

一、确认控制器代码正确性 #

确保控制器注解与参数配置完全匹配要求，示例代码如下：

import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

@RestController
public class TodoController {

    @PostMapping(value = "/saveTodo", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    public String saveTodo(
            @RequestParam("title") String title,
            @RequestParam("description") String description,
            @RequestParam("file") MultipartFile file) {
        // 业务逻辑实现
        return "Todo saved: " + title + ", file: " + file.getOriginalFilename();
    }
}

注意事项：

• 必须指定consumes = MediaType.MULTIPART_FORM_DATA_VALUE，明确接口接收多表单数据
• @RequestParam的参数名需与请求中的key完全一致，大小写敏感
• 必填参数不要添加required = false，避免参数校验失效

二、Postman请求的正确配置步骤 #

1. 新建POST请求，填写接口URL（如http://localhost:8080/saveTodo）
2. 切换到Body标签，选择form-data类型
3. 依次添加三个参数：
   • Key填title，Type选择Text，Value输入具体文本内容
   • Key填description，Type选择Text，Value输入具体文本内容
   • Key填file，Type选择File，点击右侧按钮选择本地文件
4. 不要手动设置Content-Type请求头，Postman会自动生成符合要求的multipart/form-data; boundary=xxx头信息，手动设置会导致参数识别失败
5. 点击Send发送请求

三、常见问题排查点 #

• 检查参数名大小写：控制器与Postman中的参数名必须完全一致（如控制器用title，Postman不能写成Title）
• 配置文件上传限制：若使用旧版Spring Boot，需在application.properties中添加文件大小配置：

spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB

• 避免混合注解：不要同时使用@RequestBody和@RequestParam，两种注解分别对应JSON和表单数据，混用会导致参数解析冲突
• 清理错误请求头：若之前手动设置过Content-Type: application/json，需删除该配置，否则form-data参数无法被识别

四、可选方案：同时接收对象与文件 #

如果需要将文本参数封装为对象，可改用@RequestPart实现，示例代码：

import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestPart;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

@RestController
public class TodoController {

    static class TodoDto {
        private String title;
        private String description;
        
        // Getter & Setter
        public String getTitle() { return title; }
        public void setTitle(String title) { this.title = title; }
        public String getDescription() { return description; }
        public void setDescription(String description) { this.description = description; }
    }

    @PostMapping(value = "/saveTodo", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    public String saveTodo(
            @RequestPart("todo") TodoDto todoDto,
            @RequestPart("file") MultipartFile file) {
        return "Todo saved: " + todoDto.getTitle() + ", file: " + file.getOriginalFilename();
    }
}

对应的Postman配置：

• form-data中添加todo参数，Type选Text，Value填写JSON字符串（如{"title":"Buy milk", "description":"Low-fat"}），右侧下拉选择JSON类型
• 添加file参数，Type选File并选择本地文件

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