Go语言中正确实现HTTP POST请求：从PHP cURL迁移的实践指南-Golang-PHP中文网

Go语言中正确实现HTTP POST请求：从PHP cURL迁移的实践指南

本文深入探讨了从php curl迁移http post请求到go语言时可能遇到的问题，特别是请求体数据处理的差异。我们将分析php和go在构建post请求时的不同机制，并通过示例代码展示如何正确地在go中发送url编码或json格式的post数据，以避免常见的“无法授权请求”错误。

在现代服务开发中，不同编程语言间的API调用迁移是常见任务。然而，即使是看似简单的HTTP POST请求，也可能因语言特性和库设计的差异而导致意外行为。本文将以PHP的cURL和Go语言的net/http包为例，详细阐述在实现HTTP POST请求时，特别是处理请求体数据方面的关键区别，并提供正确的Go语言实现方案。

理解HTTP POST请求的核心机制

HTTP POST请求的核心在于将数据作为请求的“主体”（body）发送到服务器。与GET请求将数据附加在URL的查询字符串中不同，POST请求的数据通常不直接暴露在URL上，而是通过请求体传输。服务器在接收到POST请求时，会解析请求头中的Content-Type字段来确定如何解码请求体中的数据。

PHP cURL实现分析

在PHP中，使用cURL库发送POST请求是一种常见做法。以下是一个典型的PHP cURL POST请求示例：

<?php
function api_query(array $req = array()) {
    $key = '90294318da0162b082c3d27126be80c3873955f9';
    $req['method'] = 'getinfo';
    $req['nonce'] = 1394503747386411;

    // 使用 http_build_query 生成 URL 编码的 POST 数据字符串
    $post_data = http_build_query($req, '', '&');
    $sign = '75da1e3ff750286bf73d03197f1b779fbfff963fd7402941ae326509a6615eacb839b44f236b4d5ee6cff39321e7b35e9563a9a2075e99df0f4ee3b732999348';

    $headers = array(
        'Sign: '.$sign,
        'Key: '.$key,
    );

    static $ch = null;
    if (is_null($ch)) {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; Cryptsy API PHP client; '.php_uname('s').'; PHP/'.phpversion().')');
    }
    curl_setopt($ch, CURLOPT_URL, 'https://api.cryptsy.com/api');
    // 关键：CURLOPT_POSTFIELDS 将数据作为请求体发送
    curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

    $res = curl_exec($ch);
    // ... 错误处理与结果解析
    return json_decode($res, true);
}

api_query();
?>

登录后复制

在上述PHP代码中，http_build_query($req, '', '&')函数负责将关联数组$req转换为URL编码的字符串（例如method=getinfo&nonce=1394503747386411）。随后，curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data)指令明确地告诉cURL将这个字符串作为HTTP POST请求的请求体发送。默认情况下，cURL会自动设置Content-Type头为application/x-www-form-urlencoded。

立即学习“PHP免费学习笔记（深入）”；

Go语言中常见的错误实现及原因

当尝试将上述PHP逻辑迁移到Go语言时，一个常见的错误是未能正确处理POST请求的数据体。以下是Go语言中一个错误的实现尝试：

package main

import (
    "bytes"
    "context"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
    "strings"

    "google.golang.org/appengine"
    "google.golang.org/appengine/urlfetch"
)

func PrivateCall(c appengine.Context) (map[string]interface{}, error) {
    AuthAPI := "https://api.cryptsy.com/api"
    APIKey := "90294318da0162b082c3d27126be80c3873955f9"
    tr := urlfetch.Transport{Context: c} // App Engine specific transport

    values := url.Values{}
    values.Set("method", "getinfo")
    values.Set("nonce", "1394503747386411")

    signature := "75da1e3ff750286bf73d03197f1b779fbfff963fd7402941ae326509a6615eacb839b44f236b4d5ee6cff39321e7b35e9563a9a2075e99df0f4ee3b732999348"

    // 错误点：将 POST 数据作为查询参数附加到 URL
    req, err := http.NewRequest("POST", AuthAPI+"?"+values.Encode(), nil)
    if err != nil {
        c.Infof("API - Call - error 2 - %s", err.Error())
        return nil, err
    }
    req.Header.Set("Key", APIKey)
    req.Header.Set("Sign", signature)

    // ... 后续请求发送和响应处理
    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代码的问题在于：

values.Encode()的误用： values.Encode()方法会将url.Values结构体编码为key1=value1&key2=value2形式的字符串，这通常用于URL的查询参数。
http.NewRequest的第三个参数： http.NewRequest的第三个参数期望一个io.Reader接口，用于提供请求体的数据。在错误示例中，传入了nil，这意味着请求体是空的。
URL构造： AuthAPI+"?"+values.Encode()将POST数据错误地附加到了URL的查询字符串部分。虽然HTTP规范允许POST请求带查询参数，但服务器通常期望POST数据在请求体中，尤其是在API认证和数据提交场景中。

这种错误会导致服务器收到一个空的请求体，从而无法找到预期的POST数据，进而返回“Unable to Authorize Request - Check Your Post Data”之类的错误信息。

Mootion

Mootion是一个革命性的3D动画创作平台，利用AI技术来简化和加速3D动画的制作过程。

177

查看详情

Go语言中正确实现HTTP POST请求

在Go语言中，正确发送HTTP POST请求的关键在于将请求体数据封装成一个io.Reader，并将其作为http.NewRequest的第三个参数传入。同时，需要设置正确的Content-Type请求头，以告知服务器请求体的格式。

我们将提供两种常见的POST数据格式的实现方式：application/x-www-form-urlencoded（与PHP cURL行为一致）和application/json（API开发中常用）。

1. 发送 application/x-www-form-urlencoded 数据

这种方式最直接地对应PHP http_build_query 和 CURLOPT_POSTFIELDS 的行为。

package main

import (
    "bytes"
    "context"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
    "strings" // 引入 strings 包

    "google.golang.org/appengine"
    "google.golang.org/appengine/urlfetch"
)

// CorrectPrivateCallWithForm 演示如何发送 application/x-www-form-urlencoded 格式的 POST 请求
func CorrectPrivateCallWithForm(c appengine.Context) (map[string]interface{}, error) {
    AuthAPI := "https://api.cryptsy.com/api"
    APIKey := "90294318da0162b082c3d27126be80c3873955f9"
    tr := urlfetch.Transport{Context: c}

    values := url.Values{}
    values.Set("method", "getinfo")
    values.Set("nonce", "1394503747386411")

    signature := "75da1e3ff750286bf73d03197f1b779fbfff963fd7402941ae326509a6615eacb839b44f236b4d5ee6cff39321e7b35e9563a9a2075e99df0f4ee3b732999348"

    // 将 URL 编码的字符串作为请求体
    postData := values.Encode()
    req, err := http.NewRequest("POST", AuthAPI, strings.NewReader(postData)) // 使用 strings.NewReader
    if err != nil {
        c.Errorf("Failed to create request: %v", err)
        return nil, err
    }

    // 设置必要的请求头
    req.Header.Set("Key", APIKey)
    req.Header.Set("Sign", signature)
    req.Header.Set("Content-Type", "application/x-www-form-urlencoded") // 明确指定 Content-Type

    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 error: %v, raw body: %s", err, body)
        return nil, err
    }
    return result, nil
}

登录后复制

关键点：

strings.NewReader(postData)：将values.Encode()生成的字符串转换为io.Reader接口，作为请求体。
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")：明确设置Content-Type头，告知服务器请求体是URL编码的表单数据。

2. 发送 application/json 数据

如果目标API支持JSON格式的POST数据，那么发送JSON数据是另一种常见的且通常更现代的方式。

package main

import (
    "bytes" // 引入 bytes 包
    "context"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"

    "google.golang.org/appengine"
    "google.golang.org/appengine/urlfetch"
)

// CorrectPrivateCallWithJSON 演示如何发送 application/json 格式的 POST 请求
func CorrectPrivateCallWithJSON(c appengine.Context) (map[string]interface{}, error) {
    AuthAPI := "https://api.cryptsy.com/api"
    APIKey := "90294318da0162b082c3d27126be80c3873955f9"
    tr := urlfetch.Transport{Context: c}

    // 定义一个匿名结构体来表示要发送的 JSON 数据
    data := struct {
        Method string `json:"method"`
        Nonce  string `json:"nonce"`
    }{
        "getinfo",
        "1394503747386411",
    }

    signature := "75da1e3ff750286bf73d03197f1b779fbfff963fd7402941ae326509a6615eacb839b44f236b4d5ee6cff39321e7b35e9563a9a2075e99df0f4ee3b732999348"

    // 将 Go 结构体编码为 JSON 字节数组
    jsonData, err := json.Marshal(data)
    if err != nil {
        c.Errorf("Failed to marshal JSON data: %v", err)
        return nil, err
    }

    // 使用 bytes.NewBuffer 将 JSON 字节数组包装成 io.Reader
    req, err := http.NewRequest("POST", AuthAPI, bytes.NewBuffer(jsonData))
    if err != nil {
        c.Errorf("Failed to create request: %v", err)
        return nil, err
    }

    // 设置必要的请求头
    req.Header.Set("Key", APIKey)
    req.Header.Set("Sign", signature)
    req.Header.Set("Content-Type", "application/json") // 明确指定 Content-Type

    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 error: %v, raw body: %s", err, body)
        return nil, err
    }
    return result, nil
}

登录后复制

关键点：

json.Marshal(data)：将Go结构体编码为JSON格式的字节数组。
bytes.NewBuffer(jsonData)：将字节数组包装成io.Reader，作为请求体。
req.Header.Set("Content-Type", "application/json")：明确设置Content-Type头，告知服务器请求体是JSON格式。

注意事项与最佳实践

Content-Type头的重要性： 始终确保你的POST请求设置了正确的Content-Type头。服务器依赖此头来正确解析请求体。常见的有：
- application/x-www-form-urlencoded：用于传统的HTML表单提交。
- application/json：用于发送JSON数据。
- multipart/form-data：用于文件上传或包含多个部分数据的表单。
io.Reader接口： Go的net/http包在设计上非常依赖io.Reader和io.Writer接口。对于HTTP请求体，你需要提供一个实现了io.Reader接口的对象。strings.NewReader和bytes.NewBuffer是两种常用的构造方法。
错误处理： 在实际应用中，对网络请求的每一步都进行充分的错误处理至关重要，包括请求创建、发送、响应读取和数据解析。
http.Client的复用： 在生产环境中，尤其是在Google App Engine等云环境中，应复用http.Client实例（或其底层urlfetch.Transport）。每次请求都创建一个新的客户端会增加资源开销。
SSL/TLS验证： PHP示例中使用了CURLOPT_SSL_VERIFYPEER, FALSE来禁用SSL证书验证。在Go中，默认是开启验证的，并且强烈建议在生产环境中保持开启以确保安全性。如果确实需要禁用（例如在某些测试或特定内部环境中），可以通过配置http.Transport的TLSClientConfig来实现，但这通常不是推荐的做法。

总结

从PHP cURL迁移HTTP POST请求到Go语言时，核心区别在于Go的net/http包要求将POST请求体数据作为io.Reader传入，并且需要显式设置Content-Type请求头。通过正确使用strings.NewReader或bytes.NewBuffer来构建请求体，并设置相应的Content-Type，可以避免因请求体解析失败导致的认证或数据处理错误。理解这些底层机制，是编写健壮、高效的跨语言HTTP客户端的关键。

以上就是Go语言中正确实现HTTP POST请求：从PHP cURL迁移的实践指南的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

Go与PHP HTTP请求差异解析：签名与POST数据处理最佳实践 Go与PHP HTTP POST请求签名差异解析与实践 Go语言中HTTP POST请求与API签名：从PHP迁移的常见陷阱与解决方案 Go语言与PHP在HTTP POST请求中处理表单数据及签名的最佳实践 Go与PHP：构建一致的HTTP POST请求与API签名验证