当前位置:

首页 > 编程开发 > Postman中四种请求体格式用法全解析及SpringBoot接收指南

Postman中四种请求体格式用法全解析及SpringBoot接收指南

Postman提供四种请求体格式:FormData支持文本与文件混合传输;x-www-form-urlencoded仅文本需URL编码;Raw适合JSON等结构化数据;Binary用于单个二进制文件。SpringBoot通过@RequestParam、@RequestPart等注解分别处理。

本文目录

    在接口开发中,请求体格式的选择直接影响数据传输的效率和正确性。Postman 作为主流的接口调试工具,提供了 Form Data、x-www-form-urlencoded、Raw、Binary 四种常用请求体格式。本文将详细解析这四种格式的区别,重点对比 Form Data 与 x-www-form-urlencoded,并结合 Spring Boot 示例说明如何正确接收参数。

    一、四种请求体格式的核心区别

    Postman 的 Body 选项中,四种格式的设计初衷和适用场景差异显著,具体如下:

    1. Form Data(multipart/form-data)

    本质:通过“分隔符(boundary)”分割多个键值对的复合格式,支持文本和二进制数据(如文件)。

    核心特点:

    • 每个字段独立成块,包含字段名、内容类型(如文本/文件)等元信息。
    • 非 ASCII 字符(如中文、特殊符号)无需手动编码,直接传输原始字节。
    • 支持同时传递文本和文件(例如:上传用户头像时,同时传递用户 ID 和昵称)。

    请求体示例(简化版):

    --Boundary123456  // 分隔符(自动生成)
    Content-Disposition: form-data; name="username"  // 文本字段名
    张三  // 字段值(中文无需编码)
    --Boundary123456
    Content-Disposition: form-data; name="a vatar"; filename="head.jpg"  // 文件字段
    Content-Type: image/jpeg  // 文件类型
    [二进制文件内容]  // 直接传输文件字节
    --Boundary123456--  // 结束符

    2. x-www-form-urlencoded

    本质:将键值对拼接为字符串(如 key1=value1&key2=value2),并对非 ASCII 字符进行 URL 编码。

    核心特点:

    • 仅支持文本数据,不支持文件传输(因编码后为纯文本,无法承载二进制)。
    • 数据体积小,编码后为单一字符串,适合简单表单提交(如登录、搜索框查询)。

    请求体示例:

    username=%E5%BC%A0%E4%B8%89&age=20  // "张三"被URL编码为%E5%BC%A0%E4%B8%89

    3. Raw

    本质:纯文本格式,支持 JSON、XML、HTML 等结构化数据,需手动指定 Content-Type。

    核心特点:

    • 适合传递复杂结构化数据(如 API 接口的 JSON 请求体)。
    • Postman 会根据选择的格式自动设置 Content-Type(例如:选 JSON 则自动添加 application/json 头)。

    常见场景:后端接口要求接收 JSON 格式的用户信息(如 {"name":"张三","age":20})。

    4. Binary

    本质:二进制数据流,对应 Content-Type: application/octet-stream。

    核心特点:

    • 仅支持单个二进制文件(如上传压缩包、图片),无键值对概念。
    • 直接传输文件原始字节,适合纯文件上传场景(如“上传附件”功能)。

    二、重点:Form Data 与 x-www-form-urlencoded 的核心区别

    虽然两者都以键值对形式传输数据,但在编码方式、支持类型、适用场景上有本质区别,具体对比如下:

    对比维度 Form Data(multipart/form-data) x-www-form-urlencoded
    编码方式 用分隔符分割多个字段,每个字段独立成块 所有字段拼接为单一字符串,URL编码
    支持数据类型 文本 + 二进制文件(如图片、文档) 仅支持文本(无法传输文件)
    非ASCII字符处理 直接传输原始字节(无需编码) 强制URL编码(如中文→%E5%BC%A0…)
    数据体积 较大(含分隔符和元信息) 较小(纯字符串)
    适用场景 上传文件、混合文本与二进制数据 简单表单提交(登录、搜索、参数提交)
    Spring Boot接收差异 支持 MultipartFile 接收文件 仅支持文本参数,无法接收文件

    一句话总结:如果需要传文件,必须用 Form Data;如果只是简单文本提交,x-www-form-urlencoded 更轻量。

    三、Postman 中如何设置四种格式

    1. Form Data 设置

    步骤:Body → 选择 form-data → 点击“+”添加键值对。

    • 文本参数:默认选“Text”,直接输入键和值(如 username: 张三)。
    • 文件参数:选择“File”,点击“Select Files”上传文件(如 a vatar: head.jpg)。

    注意:Postman 会自动添加 Content-Type: multipart/form-data 及分隔符,无需手动设置。

    2. x-www-form-urlencoded 设置

    步骤:Body → 选择 x-www-form-urlencoded → 直接添加键值对(如 name: 张三、age: 20)。

    注意:Postman 会自动对非 ASCII 字符编码(如“张三”→%E5%BC%A0%E4%B8%89),并设置 Content-Type: application/x-www-form-urlencoded。

    3. Raw 设置

    步骤:Body → 选择 raw → 右侧下拉框选格式(如 JSON)→ 输入对应格式内容(如 {"name":"张三","age":20})。

    注意:格式需与内容匹配(如选 JSON 就必须输入合法 JSON 字符串)。

    4. Binary 设置

    步骤:Body → 选择 binary → 点击“Select File”选择单个二进制文件(如 test.zip)。

    注意:一次只能传一个文件,无键名,仅传输文件字节流。

    四、Spring Boot 中如何接收四种格式的参数

    1. 接收 Form Data(multipart/form-data)

    适用于文本+文件混合传输,用 @RequestParam 接收文本,MultipartFile 接收文件。

    @RestController
    public class FormDataController {
        // 接收文本+文件
        @PostMapping("/upload")
        public String handleFormData(
                @RequestParam("username") String username,  // 文本参数
                @RequestParam("a vatar") MultipartFile a vatar  // 文件参数
        ) {
            String filename = a vatar.getOriginalFilename(); // 获取文件名
            long fileSize = a vatar.getSize(); // 获取文件大小
            return "收到用户:" + username + ",上传文件:" + filename + "(大小:" + fileSize + "字节)";
        }
    }

    2. 接收 x-www-form-urlencoded

    适用于纯文本键值对,直接用 @RequestParam 接收(与 Form Data 的文本参数接收方式一致)。

    @RestController
    public class UrlEncodedController {
        @PostMapping("/submit")
        public String handleUrlEncoded(
                @RequestParam("name") String name,  // 接收文本参数
                @RequestParam("age") Integer age    // 自动转换类型
        ) {
            return "收到用户:" + name + ",年龄:" + age;
        }
    }

    3. 接收 Raw

    适用于结构化数据(如 JSON、XML),用 @RequestBody 绑定到对象或字符串。

    // 定义接收JSON的实体类
    public class User {
        private String name;
        private Integer age;
        // 必须提供getter和setter(Spring通过反射赋值)
        public String getName() { return name; }
        public void setName(String name) { this.name = name; }
        public Integer getAge() { return age; }
        public void setAge(Integer age) { this.age = age; }
    }
    
    @RestController
    public class RawController {
        // 接收JSON并自动绑定到User对象
        @PostMapping("/user")
        public String handleJson(@RequestBody User user) {
            return "用户信息:姓名=" + user.getName() + ",年龄=" + user.getAge();
        }
        
        // 直接接收原始XML文本
        @PostMapping("/xml")
        public String handleXml(@RequestBody String xml) {
            return "收到XML内容:" + xml;
        }
    }

    4. 接收 Binary

    适用于单个二进制文件,用 MultipartFile 接收(与 Form Data 的文件接收方式相同)。

    @RestController
    public class BinaryController {
        @PostMapping("/upload-file")
        public String handleBinary(@RequestParam("file") MultipartFile file) {
            return "收到二进制文件:" + file.getOriginalFilename()
                    + ",类型:" + file.getContentType();
        }
    }

    五、总结

    请求体格式 适用场景 核心特点 Spring Boot 接收方式
    Form Data 文本+文件混合传输 支持二进制,分隔符分隔 @RequestParam(文本)+ MultipartFile(文件)
    x-www-form-urlencoded 纯文本表单提交 URL编码,仅支持文本 @RequestParam
    Raw 结构化数据(JSON/XML等) 纯文本,需指定格式 @RequestBody(绑定对象或字符串)
    Binary 单个二进制文件 无键值对,原始字节流 MultipartFile

    掌握这四种格式的差异,尤其是 Form Data 与 x-www-form-urlencoded 的区别,能帮助我们在前后端联调中快速选择合适的传输方式,避免“传文件失败”“参数乱码”等常见问题。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    AG2 1.3.1沙箱、MCP Apps与A2UI兼容变化分别意味着什么
    AG2 1.3.1沙箱、MCP Apps与A2UI兼容变化分别意味着什么

    解释AG2 1.3.1的A2UI version与protocol_version差异、E2B和boxd后端、MCP Apps连接与独立缓存写入统计,提供只读包版本查询。

    Arcane 3.0.1的代理启动与证书验证应怎样分开评估
    Arcane 3.0.1的代理启动与证书验证应怎样分开评估

    Arcane 3.0.1把代理启动中不该承担的管理端任务与身份验证要求分开处理:agent跳过manager专属工作,旧edge SPIFFE客户端证书被拒绝,更新始终验证。部署影响取决于实际使用的节点角色、证书及配置保存路径。

    ffmpeg-skill 3.10.0与3.10.1的使用边界怎么看
    ffmpeg-skill 3.10.0与3.10.1的使用边界怎么看

    ffmpeg-skill 3.10.0与3.10.1对应两个连续维护版本。多片段项目的渲染与时间线导出现在按一致的画幅和帧率规则处理。遇到容器不接受的数据流时,新版会尽量只移除受影响的数据流,让符合条件的字幕仍能保留。

    last30days-skill 4.1.0与4.2.0的使用边界怎么看
    last30days-skill 4.1.0与4.2.0的使用边界怎么看

    last30days-skill 4.1.0与4.2.0对应两个连续维护版本。两版更新让社区检索有了可选的登录路径,并按主题覆盖程度决定是否保留只在评论中命中的帖子。结果的来源和相关性规则会影响最终列出的讨论。

    rust-analyzer v0.3.3121 稳定版修复怎样影响常量与条件属性?
    rust-analyzer v0.3.3121 稳定版修复怎样影响常量与条件属性?

    rust-analyzer v0.3.3121 稳定版修复大 u128 转为负浮点数的问题,并为 target_os 与 target_env 补齐 macOS、iOS、Android 和 musl 相关候选。

    llama.cpp b12464 的 Q8_0 优化对应哪条 OpenCL 路径?
    llama.cpp b12464 的 Q8_0 优化对应哪条 OpenCL 路径?

    llama.cpp b12464 为 OpenCL A7 增加 Q8_0 非 MoE 二进制内核,解释 Adreno X1、矩阵乘法和适用条件。

    llama.cpp b12463 的视觉位置嵌入修复影响哪些输入?
    llama.cpp b12463 的视觉位置嵌入修复影响哪些输入?

    llama.cpp b12463 修正 Muse Glimmer 视觉编码器缩放位置嵌入时的坐标顺序,使其与训练一致,解释非方形图像为何更能体现差异。

    llama.cpp b12458的YuE2-3B支持有哪些使用边界
    llama.cpp b12458的YuE2-3B支持有哪些使用边界

    llama.cpp b12458加入YuE2-3B,修正流式生成,并按序列保存采样分数。

    Ducter 0.0.67 如何理解任务消息时机与代理记录读取
    Ducter 0.0.67 如何理解任务消息时机与代理记录读取

    Ducter 0.0.67 区分运行中引导与当前一轮后的补充消息,同时把其他代理记录的读取交给用户主动触发。两项变化分别影响任务执行时机和背景信息来源。

    llama.cpp b12441/b12442/b12448/b12449/b12451/b12452/b12453/b12455/b12456 对比?
    llama.cpp b12441/b12442/b12448/b12449/b12451/b12452/b12453/b12455/b12456 对比?

    llama.cpp b12441、b12442、b12448、b12449、b12451、b12452、b12453、b12455、b12456 均为预发布,涉及后端、聊天模板、设备参数、界面与音频,按场景对应各构建。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。