HTTP POST请求是否允许同时传递payload与URL查询参数

合规性说明 #

这种做法完全符合HTTP标准规范。HTTP协议从未对POST请求的参数传递方式做限制：查询参数是URL的原生组成部分，和请求方法没有绑定关系，只要服务端可以正常解析URL参数和请求体内容，这种用法就是合法的。
你给出的调用示例本身没有语法或规范层面的问题：

# 携带请求体和查询参数的POST请求示例
curl -X POST -H "Content-Type: application/json" -d@data.json http://host.com/api?q=1

参数放置的最佳实践 #

两种参数位置没有绝对的对错，只需要匹配参数的语义即可：

• 查询参数适合放置操作标识、元数据、过滤规则、非敏感的控制类参数，比如示例中的q=1如果是用来指定对请求体执行的逻辑类型，放在URL里反而更利于链路排查：网关、日志系统不需要解析JSON请求体就可以直接识别操作类型，调试成本更低
• 请求体适合放置业务实体数据、大体积参数、敏感参数，符合POST请求提交业务资源的语义

重构决策建议 #

不需要为了「符合规范」盲目把q=1迁移到请求体中，仅当出现以下情况时才需要做重构：

• q参数本身属于业务数据的一部分，和请求体内的字段有强关联关系
• q参数存在敏感内容，会被URL日志记录导致泄露
• 参数长度已经超过了服务端、反向代理对URL长度的限制

内容的提问来源于stack exchange，提问作者Valentin