本文旨在深入探讨php与golang在执行http post请求时数据传输机制的差异，特别是在处理请求体数据时的常见误区。我们将通过对比php `curl`与go `net/http`库的实现，详细分析golang中将post数据错误地作为url查询参数发送的问题，并提供两种正确的golang实现方式：一是模拟php的 `application/x-www-form-urlencoded` 格式，二是根据api可能支持的json格式进行数据传输，确保请求成功授权。
理解HTTP POST请求的数据传输机制
HTTP POST请求通常用于向服务器提交数据，这些数据通常放在请求体（request body）中，而不是URL的查询字符串（query string）中。正确地构造请求体并设置相应的 Content-Type 头是成功发送POST请求的关键。
PHP中的POST数据处理
在PHP中，使用cURL库发送POST请求时，curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); 选项负责将 $post_data 的内容作为请求体发送。当 $post_data 是一个通过 http_build_query 生成的字符串时，cURL默认会设置 Content-Type: application/x-www-form-urlencoded 头。这意味着数据以键值对的形式编码，并用 & 符号连接，例如 key1=value1&key2=value2。
上述PHP代码明确地将POST数据放入了请求体。
GoLang中HTTP POST请求的常见陷阱
GoLang的 net/http 包提供了强大的HTTP客户端功能。然而，初学者常犯的一个错误是将POST请求的数据错误地附加到URL的查询字符串中，而不是放在请求体中。
立即学习“PHP免费学习笔记（深入）”；
原始的GoLang代码片段展示了这个问题：
// 错误示例
values := url.Values{}
values.Set("method", "getinfo")
values.Set("nonce", "1394503747386411")
// ...
req, err := http.NewRequest("POST", AuthAPI+"?"+values.Encode(), nil) // 错误：将POST数据编码到URL查询字符串中
// ...在这里，values.Encode() 生成的字符串被拼接到了 AuthAPI 的后面，形成了如 https://api.cryptsy.com/api?method=getinfo&nonce=1394503747386411 的URL。尽管请求方法是POST，但实际的POST数据却被当作GET请求的查询参数发送了。目标API通常会检查请求体中的数据，因此当请求体为空或格式不正确时，就会返回“Unable to Authorize Request - Check Your Post Data”之类的错误。
正确实现GoLang HTTP POST请求
在GoLang中，正确发送POST请求的关键是使用 http.NewRequest 函数的第三个参数来提供请求体，并设置正确的 Content-Type 头。
方法一：发送 application/x-www-form-urlencoded 数据 (模拟PHP行为)
如果API期望的数据格式与PHP http_build_query 生成的 application/x-www-form-urlencoded 相同，可以使用以下方法：
package main
import (
"bytes"
"context"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
"net/url"
"strings"
"google.golang.org/appengine"
"google.golang.org/appengine/urlfetch"
)
// PrivateCallWithFormUrlEncoded 模拟PHP的form-urlencoded POST请求
func PrivateCallWithFormUrlEncoded(c appengine.Context) (map[string]interface{}, error) {
AuthAPI := "https://api.cryptsy.com/api"
APIKey := "90294318da0162b082c3d27126be80c3873955f9"
signature := "75da1e3ff750286bf73d03197f1b779fbfff963fd7402941ae326509a6615eacb839b44f236b4d5ee6cff39321e7b35e9563a9a2075e99df0f4ee3b732999348"
// 构造POST数据
formData := url.Values{}
formData.Set("method", "getinfo")
formData.Set("nonce", "1394503747386411")
// 将form data编码为字符串，并创建strings.Reader作为请求体
reqBody := strings.NewReader(formData.Encode())
req, err := http.NewRequest("POST", AuthAPI, reqBody)
if err != nil {
c.Infof("API - Call - error creating request - %s", err.Error())
return nil, err
}
// 设置HTTP头，包括Content-Type
req.Header.Set("Key", APIKey)
req.Header.Set("Sign", signature)
req.Header.Set("Content-Type", "application/x-www-form-urlencoded") // 关键：指定数据类型
tr := urlfetch.Transport{Context: c}
resp, err := tr.RoundTrip(req)
if err != nil {
c.Errorf("API post error: %s", err)
return nil, err
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
c.Errorf("API read error: could not read body: %s", err)
return nil, err
}
result := make(map[string]interface{})
err = json.Unmarshal(body, &result)
if err != nil {
c.Infof("Unmarshal: %v", err)
c.Infof("%s", body)
return nil, err
}
return result, nil
}关键点：
- strings.NewReader(formData.Encode())：将 url.Values 编码后的字符串作为 io.Reader 传递给 http.NewRequest 的第三个参数。
- req.Header.Set("Content-Type", "application/x-www-form-urlencoded")：明确告知服务器请求体的数据格式。
方法二：发送 application/json 数据 (基于答案的建议)
如果目标API支持或更倾向于接收JSON格式的POST数据（这在现代API中非常常见），可以按照提供的答案进行实现：
package main
import (
"bytes"
"context"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
"net/url" // Still needed for url.Values if constructing formData first, but not for JSON directly
"google.golang.org/appengine"
"google.golang.org/appengine/urlfetch"
)
// PrivateCallWithJSONData 使用JSON格式发送POST请求
func PrivateCallWithJSONData(c appengine.Context) (map[string]interface{}, error) {
AuthAPI := "https://api.cryptsy.com/api"
APIKey := "90294318da0162b082c3d27126be80c3873955f9"
signature := "75da1e3ff750286bf73d03197f1b779fbfff963fd7402941ae326509a6615eacb839b44f236b4d5ee6cff39321e7b35e9563a9a2075e99df0f4ee3b732999348"
// 构造JSON数据结构
data := struct {
Method string `json:"method"` // 注意字段名和JSON标签
Nonce string `json:"nonce"`
}{
"getinfo",
"1394503747386411",
}
// 将数据结构编码为JSON字节切片
postData, err := json.Marshal(data)
if err != nil {
c.Errorf("JSON marshal error: %s", err)
return nil, err
}
// 使用bytes.NewBuffer将JSON数据作为请求体
reqBody := bytes.NewBuffer(postData)
req, err := http.NewRequest("POST", AuthAPI, reqBody)
if err != nil {
c.Infof("API - Call - error creating request - %s", err.Error())
return nil, err
}
// 设置HTTP头，包括Content-Type
req.Header.Set("Key", APIKey)
req.Header.Set("Sign", signature)
req.Header.Set("Content-Type", "application/json") // 关键：指定数据类型为JSON
tr := urlfetch.Transport{Context: c}
resp, err := tr.RoundTrip(req)
if err != nil {
c.Errorf("API post error: %s", err)
return nil, err
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
c.Errorf("API read error: could not read body: %s", err)
return nil, err
}
result := make(map[string]interface{})
err = json.Unmarshal(body, &result)
if err != nil {
c.Infof("Unmarshal: %v", err)
c.Infof("%s", body)
return nil, err
}
return result, nil
}关键点：
- 定义一个Go结构体来表示要发送的JSON数据。
- 使用 json.Marshal 将Go结构体转换为JSON格式的字节切片。
- 使用 bytes.NewBuffer 将字节切片包装成 io.Reader 作为请求体。
- req.Header.Set("Content-Type", "application/json")：明确告知服务器请求体是JSON格式。
注意事项
- Content-Type 头的重要性： 无论是发送 application/x-www-form-urlencoded 还是 application/json，正确设置 Content-Type 头至关重要。服务器会根据这个头来解析请求体中的数据。如果设置错误或缺失，服务器可能无法正确识别数据格式，导致授权失败或数据解析错误。
- API文档： 在实现任何API客户端时，始终优先查阅API的官方文档。文档会明确指出POST请求期望的数据格式（例如，form-urlencoded、JSON、XML等）以及必需的请求头。
- 错误处理： 在GoLang中，对HTTP请求的各个阶段（创建请求、发送请求、读取响应、解析响应）进行充分的错误处理是良好编程实践。
- Google App Engine urlfetch： 在Google App Engine环境中，推荐使用 google.golang.org/appengine/urlfetch.Transport 来执行HTTP请求，因为它会自动处理App Engine环境下的网络代理和配额管理。
总结
从PHP迁移到GoLang进行HTTP POST请求时，核心差异在于如何构造和发送请求体数据。PHP的cURL库通过 CURLOPT_POSTFIELDS 自动处理了 application/x-www-form-urlencoded 格式。而在GoLang中，开发者需要显式地将数据编码成字节流，并通过 http.NewRequest 的第三个参数传入，同时手动设置 Content-Type 请求头。理解并正确应用这些机制，能够有效避免“Check Your Post Data”之类的授权问题，确保不同语言间API调用的兼容性和成功率。
