ESP32 HTTP POST请求参数格式问题排查求助

问题根源 #

你当前的POST请求参数传递方式完全错误：

• 你设置了Content-Type: application/x-www-form-urlencoded，但却把参数message拼在了URL的查询字符串（/?message=xxx）里，而非放在POST请求体中。
• 服务器端request->hasParam("message", true)的第二个参数true明确指定从POST请求体/表单中读取参数，自然找不到URL里的参数，哪怕请求返回200、路由触发成功也没用。

修复方案 #

客户端代码修正 #

将参数从URL中移除，构造符合application/x-www-form-urlencoded格式的请求体数据，传入HTTPClient::POST()方法的第二个参数：

// 构造正确的表单格式请求体
String postData = "message=" + message;
httpClient.addHeader("Content-Type", "application/x-www-form-urlencoded");
// 第一个参数是服务器路由路径，第二个参数是POST请求体数据
int httpCode = httpClient.POST("/", postData);

服务器代码无需修改 #

你的服务器POST路由中request->hasParam("message", true)的写法是正确的，修正客户端后即可正常获取参数。

验证建议 #

• 客户端可打印postData内容，确认格式为message=你的内容。
• 服务器端可添加调试代码，查看请求体内容：

  // 在POST路由中添加
  Serial.println("POST请求体内容：");
  Serial.println(request->client()->readString());
  

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