API传JSON取数:需用RequestBody吗?选GET还是POST?
API请求选型:JSON传参时的GET/POST与RequestBody选择
1. GET还是POST?
- 优先看场景和兼容性:如果你的需求是纯获取数据(无服务器状态变更),GET是语义上的首选,但GET请求体传JSON的兼容性极差——HTTP规范没禁止,但几乎所有浏览器、网关、服务端框架要么忽略GET的请求体,要么处理起来有坑,所以只要你必须传JSON,别选GET。
- POST是更稳妥的选择:虽然POST常和“创建/修改”操作绑定,但HTTP规范并没有限制它只能做写操作。当需要传递复杂结构化数据(比如JSON)时,POST+请求体是行业通用方案,所有主流工具链(客户端、服务端框架、网关)都能完美支持。
2. 是否需要使用RequestBody?
- 选POST的话:必须用RequestBody传递JSON,这是标准做法。不管是Spring Boot中的
@RequestBody注解,还是Node.js Express里的express.json()中间件,都是处理POST请求体JSON的常规手段。 - 硬选GET的话:技术上能把JSON塞进请求体,但完全不推荐——你会遇到缓存失效、日志解析异常、浏览器不支持等一堆问题,还得自己手动处理请求体解析,纯粹给自己添乱。
额外实践建议
- 别被“GET只能传URL参数”的刻板印象束缚,但也别挑战生态兼容性,能用POST解决的就别折腾GET。
- 如果JSON数据非常简单,也可以尝试把JSON转成URL参数(比如
?filter={"id":123}),但这种方式有URL长度限制,可读性差,不如POST+RequestBody简洁可靠。
内容的提问来源于stack exchange,提问作者Mateus Bodanese
相关产品推荐
相关产品推荐

