Grails控制器大POST请求时params为空问题排查

DevOps 小满

2026-6-30

问题描述

使用Python requests库向Grails服务器发送大体积POST请求时遇到异常：

请求代码：requests.post(UPLOAD_URL, data=data, headers=HEADERS)
当data体积约2MB时，Grails控制器中params为空
小体积数据请求正常
已确认：NodeJS上传6.5MB数据无问题，Grails的grails.controllers.upload.requestMaxSize配置正确，问题出在python-requests端

可能的解决方法

改用json参数替代data参数
requests的data参数默认以application/x-www-form-urlencoded格式发送数据，大体积数据可能触发服务器端解析异常。如果你的负载是JSON格式，直接用json参数发送，requests会自动设置正确的Content-Type: application/json头，且对大JSON数据的处理更适配：
```
requests.post(UPLOAD_URL, json=data, headers=HEADERS)
```

禁用分块传输编码
requests在发送大体积data时可能自动启用分块编码（Transfer-Encoding: chunked），部分Grails版本对分块编码的表单数据解析存在问题。可以手动设置Content-Length头来强制禁用分块：

import json

# 若data是字典，先序列化为字符串
payload = json.dumps(data)
HEADERS['Content-Length'] = str(len(payload))
# 确保headers中没有Transfer-Encoding头
HEADERS.pop('Transfer-Encoding', None)

response = requests.post(UPLOAD_URL, data=payload, headers=HEADERS)

简化请求头
检查自定义HEADERS中是否包含可能干扰解析的字段（如Accept-Encoding、多余的Content-Type），尝试只保留必要的头信息（如授权头）后重新测试。
使用会话对象发送请求
尝试用requests.Session创建会话后发送请求，会话对象的连接管理逻辑可能解决大请求的传输问题：
```
with requests.Session() as session:
    response = session.post(UPLOAD_URL, data=data, headers=HEADERS)
```