讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

Postman怎么传带方括号的参数名_Postman特殊参数名称填写方法

风伟大大_9767

风伟大大_9767

发布时间:2026-11-09 11:32:20

|

151人浏览过

|

来源于php中文网

原创

Postman中参数名含[和]时,x-www-form-urlencoded需手动URL编码为[],form-data可直接填写原样,JSON中应避免使用而改用嵌套对象。

postman怎么传带方括号的参数名_postman特殊参数名称填写方法

Postman 里参数名含 [ 和 ] 怎么填?

直接在 Params 或 Body 中写 user[name]、ids[0] 这类带方括号的参数名,后端收不到——不是 Postman 不支持,而是它默认把方括号当普通字符处理,没做特殊转义或格式适配。

x-www-form-urlencoded 下带方括号的 key 要手动 URL 编码

这类参数常见于传统 PHP/Laravel/ThinkPHP 后端,依赖 name="user[name]" 这种 HTML 表单语法解析嵌套结构。Postman 的 x-www-form-urlencoded 模式本身不自动编码方括号,必须人工处理:

  • [ 要替换成 [,] 替换成 ]
  • 例如:user[name] → 填成 user[name];roles[0][id] → 填成 roles[0][id]
  • 如果不编码,服务端收到的是字面量 user[name],多数框架会忽略或报错(如 Spring Boot 默认不识别该格式)
  • Postman 不提供一键编码按钮,得自己替换或用在线工具辅助

form-data 模式下可直接写原样参数名

如果你的接口实际接收的是 multipart/form-data(比如上传文件同时传结构化字段),那 form-data 标签页允许你直接输入 user[name] 作为 Key,Value 填对应值,无需编码:

Postman 12.27.7
Postman 12.27.7

Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。

下载
  • Postman 会按 multipart 协议原样打包,服务端(如 PHP $_POST)能正常解析出嵌套数组
  • 注意:此时请求头 Content-Type 会自动带上 boundary,不用手填
  • 但若后端是 Spring Boot + @RequestParam,仍需确认是否开启 spring.mvc.ignore-default-model-on-redirect=false 等兼容配置,否则可能丢值

JSON 请求体中带方括号?别这么干

如果用 raw + application/json,参数名里写 "user[name]": "zhangsan" 是合法 JSON,但属于反模式:

  • 语义混乱:JSON 键名不该模拟表单语法,应改用标准嵌套对象,如 {"user": {"name": "zhangsan"}}
  • 后端反序列化容易失败:Jackson/Gson 默认不把 user[name] 映射到 User.name 字段,除非加自定义 @JsonAlias 或反序列化器
  • 调试困难:日志和 Swagger 文档都难以表达这种键名,团队协作成本高

方括号本质是表单提交的历史遗留语法,现代 API 应优先用路径参数、嵌套 JSON 或明确的扁平字段命名(如 user_name),而不是在 Postman 里硬凑编码或畸形键名。

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

5130

2023.10.13

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

20

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

20

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

40

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

40

2026.11.05

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

40

2026.11.04

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

40

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

40

2026.11.04

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Postman Native Git工作流指南
Postman Native Git工作流指南

共0课时 | 0人学习

Postman Vault密钥管理指南
Postman Vault密钥管理指南

共0课时 | 0人学习

Postman集合运行器使用指南
Postman集合运行器使用指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn