在insomnia中发送post请求需按步骤配置:①新建post请求;②填写完整url(含http/https);③headers中设content-type为application/json(json格式)或留空(表单/文件上传);④body依需求选json、form url encoded或form data并正确填写内容;⑤发送后据状态码与高亮提示排查错误。

在Insomnia中发送POST请求是接口调试最常用的操作,但新手常因Content-Type设置错误、Body格式选错或参数填错导致400/500错误,直接卡在第一步。
发送JSON格式的POST请求
适用于调用RESTful API、创建资源或提交结构化数据,后端通常要求Content-Type为application/json且请求体为合法JSON字符串。
第一步:点击左上角“+”按钮 → 选择“New Request” → 确保顶部方法栏显示为【POST】。
第二步:在URL输入框中填入完整接口地址,例如https://api.example.com/users;若漏掉协议(http://或https://)会导致请求失败,Insomnia不会自动补全。
第三步:切换到Headers标签页 → 点击“Add Header” → Key填Content-Type,Value填application/json;【这一步不可跳过,否则后端可能拒绝解析】。
第四步:切换到Body标签页 → 左侧下拉菜单选择JSON → 在编辑框中输入标准JSON,例如{"name":"张三","age":28};注意双引号必须为英文,末尾不能有多余逗号。
第五步:点击右上角“Send”,观察响应状态码是否为201或200;若返回400,优先检查JSON语法是否合法——Insomnia右侧会高亮报错位置。
发送表单数据(x-www-form-urlencoded)
模拟传统HTML表单提交,常见于登录、注册等场景,后端使用body-parser.urlencoded中间件解析。
方法一:直接填写键值对
① 新建POST请求,输入目标URL(如https://api.example.com/login);
② 切换到Body标签页 → 选择Form URL Encoded;
③ 点击“Add Parameter”,依次填入username → admin,password → 123456;
④ 发送前确认Headers标签页中【没有手动设置Content-Type】——Insomnia会在发送时自动注入application/x-www-form-urlencoded。
方法二:从已有请求快速复制
右键已存的表单请求 → 选择Duplicate → 修改URL或参数即可复用,避免重复配置。
发送含文件的POST请求(multipart/form-data)
用于头像上传、附件提交等场景,必须用Form Data模式,Raw模式或JSON模式均无法正确构造多部分边界。
① 在Body标签页中选择Form Data;
② 输入文本字段:Key填title,Value填“年度报告”;
③ 输入文件字段:Key填file,Value单元格右侧点击File按钮 → 从本地选择report.pdf;
④ 发送请求时,Insomnia会自动生成boundary并设置Content-Type为multipart/form-data;【不要手动添加Content-Type头,否则将导致冲突】。











