在使用go语言的`http.client.postform`（包括google app engine的`urlfetch.client`）发送post请求时，表单数据会作为请求体发送，而非存储在`resp.request.postform`字段中。`resp.request.postform`主要用于服务器端接收并解析传入请求的表单数据。本教程将阐明这一常见误区，并指导如何正确处理和读取http响应体，以获取服务器的实际返回内容。
Go语言HTTP客户端PostForm的工作原理
在Go语言中，net/http包提供了强大的HTTP客户端功能。当开发者需要发送一个application/x-www-form-urlencoded类型的POST请求时，通常会使用http.Client的PostForm方法。此方法签名如下：
func (c *Client) PostForm(url string, data url.Values) (resp *Response, err error)
PostForm方法接收一个URL和一个url.Values类型的数据，它会自动将url.Values编码为表单格式，并将其作为HTTP请求的请求体（Request Body）发送。
一个常见的误解是，在请求发送后，可以通过检查返回的http.Response对象中的resp.Request.PostForm字段来验证客户端发送的表单数据。然而，这种做法是错误的。
http.Request.PostForm的真实用途
http.Request结构体中包含PostForm字段，其定义如下：
立即学习“go语言免费学习笔记（深入）”；
// PostForm contains the parsed form data from POST or PUT // body parameters. // This field is only available after ParseForm is called. // The HTTP client ignores PostForm and uses Body instead. PostForm url.Values
从注释中可以清晰地看出以下几点：
- 用途： PostForm字段用于存储从POST或PUT请求体中解析出的表单数据。
- 可用性： 它只在调用了ParseForm方法之后才可用。ParseForm通常在HTTP服务器端处理传入请求时调用，用于解析客户端发送的表单数据。
- 客户端行为： 最关键的是，HTTP客户端（例如http.Client）在发送请求时会忽略PostForm字段，而是直接使用Body字段来承载请求体数据。
这意味着，当你使用client.PostForm发送数据时，你提供的url.Values会直接写入到请求的Body中，而resp.Request（这是你发送的请求的副本）中的PostForm字段将保持为空，因为它并未经过服务器端解析过程。
示例与问题复现
考虑以下在Google App Engine (GAE) Go环境中使用的代码片段：
import (
"appengine"
"appengine/urlfetch"
"net/url"
"io/ioutil" // 用于读取响应体
)
func Call(c appengine.Context, guid string, function string, parameters map[string]string) string {
client := urlfetch.Client(c) // GAE环境下的HTTP客户端
values := url.Values{}
c.Infof("原始参数: %v", parameters) // 打印原始map
for k, v := range parameters {
values.Set(k, v)
}
c.Infof("编码后的url.Values: %v", values) // 打印编码后的url.Values
// 发送POST请求
resp, err := client.PostForm("https://blockchain.info/merchant/"+guid+"/"+function, values)
if err != nil {
c.Errorf("BlockchainAPI post error: %s", err)
return ""
}
defer resp.Body.Close() // 确保关闭响应体
// 尝试检查resp.Request.PostForm，这将导致误解
c.Infof("尝试检查resp.Request.PostForm: %v", resp.Request.PostForm)
// ...
// 其他处理
// ...
return "处理完成"
}当执行上述代码，并观察日志输出时，可能会看到类似以下的结果：
2013/10/14 23:17:51 INFO: 原始参数: map[main_password:password] 2013/10/14 23:17:51 INFO: 编码后的url.Values: map[main_password:[password]] 2013/10/14 23:17:52 INFO: 尝试检查resp.Request.PostForm: map[]
可以看到，尽管values中包含了数据，但resp.Request.PostForm却显示为空map[]。这正是因为resp.Request.PostForm不用于表示客户端发送的请求体数据。
正确处理HTTP响应体
如果目的是为了获取服务器对POST请求的响应，则应该读取http.Response对象的Body字段。Body是一个io.ReadCloser接口，可以像读取文件一样读取其中的数据。
以下是修改后的代码，演示了如何正确读取服务器返回的响应体：
import (
"appengine"
"appengine/urlfetch"
"net/url"
"io/ioutil" // 用于读取响应体
)
func Call(c appengine.Context, guid string, function string, parameters map[string]string) string {
client := urlfetch.Client(c)
values := url.Values{}
for k, v := range parameters {
values.Set(k, v)
}
resp, err := client.PostForm("https://blockchain.info/merchant/"+guid+"/"+function, values)
if err != nil {
c.Errorf("BlockchainAPI post error: %s", err)
return ""
}
defer resp.Body.Close() // 确保在函数返回前关闭响应体
// 正确读取响应体
bodyBytes, readErr := ioutil.ReadAll(resp.Body)
if readErr != nil {
c.Errorf("读取响应体失败: %s", readErr)
return ""
}
answer := string(bodyBytes)
c.Infof("服务器响应体: %s", answer) // 打印服务器返回的实际内容
return answer
}通过ioutil.ReadAll(resp.Body)，我们可以将服务器返回的所有数据读取到字节切片中，然后将其转换为字符串进行处理。这是获取服务器响应的正确方式。
总结与注意事项
- client.PostForm发送数据到请求体： 当使用http.Client.PostForm时，提供的url.Values会被编码并作为HTTP请求的请求体发送。
- resp.Request.PostForm的用途： resp.Request.PostForm字段是为HTTP服务器端处理传入请求而设计的，它存储的是服务器解析客户端请求体后得到的表单数据。在客户端发送请求后，检查resp.Request.PostForm通常会得到空值，因为它没有经过服务器端的解析过程。
- 读取服务器响应： 要获取服务器对请求的响应，必须从http.Response对象的Body字段中读取数据。务必在使用完毕后关闭resp.Body，通常使用defer resp.Body.Close()。
- 验证客户端发送数据： 如果确实需要验证客户端发送的原始请求体数据，可以在发送请求前检查url.Values，或者在更复杂的场景下，可以通过实现自定义的http.RoundTripper来拦截和检查请求。但在大多数情况下，通过检查服务器的响应来确认请求是否成功处理更为实际。
理解这些基本概念对于在Go语言中正确地进行HTTP客户端编程至关重要，尤其是在调试和集成第三方API时。
