Postman提交表单后服务端收不到参数怎么办_Postman表单接收异常排查-java教程-PHP中文网

Postman选form-data导致request.getParameter()返回null，因其Content-Type为multipart/form-data，而getParameter()仅支持application/x-www-form-urlencoded；应改用x-www-form-urlencoded选项。

postman提交表单后服务端收不到参数怎么办_postman表单接收异常排查

Postman里选错body类型导致request.getParameter返回null

最常见原因是Postman的Body选项选成了form-data，它会把Content-Type设为multipart/form-data，而request.getParameter()只认application/x-www-form-urlencoded编码的表单数据。

解决方法很简单：

在Postman的Body标签页，**不要点第一个form-data按钮**
改选第二个urlencoded（即x-www-form-urlencoded）
填入键值对后，Postman会自动设置Content-Type: application/x-www-form-urlencoded;charset=utf-8
此时request.getParameter("xxx")就能正常取到值了

注意：如果接口同时要传文件，那必须用form-data，但后端就不能再依赖getParameter()，得换用MultipartHttpServletRequest或@RequestPart。

Spring Boot里误配dispatcherServlet Bean导致整个请求链路失效

Spring Boot 1.5.x项目中，如果启动类里手动注册了名字为dispatcherServlet的ServletRegistrationBean，会覆盖Spring MVC默认的DispatcherServlet实例，导致所有@PostMapping、@RequestParam等注解完全不生效——连日志都打不出来，参数自然收不到。

典型错误代码长这样：

@Bean
public ServletRegistrationBean<dispatcherservlet> dispatcherServlet() {
    return new ServletRegistrationBean(new DispatcherServlet(), "/api/*");
}</dispatcherservlet>

修复方式只有两个有效选择：

把Bean名改成别的，比如restDispatcherServlet，避免命名冲突
直接删掉这个Bean定义——除非你真在集成CXF或自定义Servlet容器，否则没必要手动注册

这个坑不会报错，只会静默失败，排查时建议先临时注释掉所有自定义@Bean，确认是否恢复再逐个放开验证。

@RequestParam在multipart/form-data下为什么拿不到参数

@RequestParam默认只解析application/x-www-form-urlencoded和query string里的参数；一旦Postman或前端用了form-data（即multipart/form-data），Spring会走Multipart解析流程，@RequestParam就失效了。

Postman Mac版

Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma

下载

对应关系很明确：

Content-Type: application/x-www-form-urlencoded → 用@RequestParam或request.getParameter()
Content-Type: multipart/form-data → 必须用@RequestPart（支持文件+普通字段混传）或MultipartFile参数

示例：后端写成这样才对

@PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public String handleUpload(
    @RequestPart("file") MultipartFile file,
    @RequestPart("desc") String desc) { ... }

如果还硬用@RequestParam，会直接400或参数为null，且无明显错误日志。

Spring Boot 1.5.x默认开启multipart但没配maxFileSize导致静默截断

Spring Boot 1.5.x默认spring.servlet.multipart.enabled=true，但没显式配置maxFileSize和maxRequestSize时，某些内嵌Tomcat版本会用极小的默认值（比如1MB），超限后请求体被截断，表单字段看起来“消失”了。

检查点：

看Postman响应状态码是不是400或500，但没具体错误信息
在Controller入口加一行log.info("content-length: {}", request.getContentLength())，对比你发的数据大小
在application.yml里补全配置：

spring:
  servlet:
    multipart:
      enabled: true
      max-file-size: 10MB
      max-request-size: 10MB

这个限制是全局的，哪怕你没传文件，只要Content-Type是multipart，就会触发校验。