如何在 Go 中正确发送带表单数据的 POST 请求

雨伟小哥_3725

雨伟小哥_3725

2026-01-17

388人浏览

原创

如何在 Go 中正确发送带表单数据的 POST 请求

本文详解 go 中使用 `net/http` 发送标准 `application/x-www-form-urlencoded` 类型 post 请求的正确方式,指出常见错误(如缺失 content-type、误用缓冲区),并提供可直接运行的健壮示例代码。

在 Go 中模拟 curl -X POST -d "key=val" ... 的行为,关键在于两点:正确设置请求头 Content-Type 和 以 URL 编码格式提交请求体。原代码中虽调用了 data.Encode() 生成了 api_token=MY_KEY&action=list_projects 字符串,但遗漏了至关重要的 Content-Type: application/x-www-form-urlencoded 头,导致服务端无法识别表单数据,从而返回“无 POST 数据”的错误。

以下是推荐的两种实现方式:

✅ 方式一:使用 http.PostForm(最简洁,推荐初学者)

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

func main() {
    apiUrl := "https://example.com/api/"
    data := url.Values{
        "api_token": {"MY_KEY"},
        "action":    {"list_projects"},
    }

    resp, err := http.PostForm(apiUrl, data)
    if err != nil {
        fmt.Printf("请求失败: %v\n", err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Printf("读取响应失败: %v\n", err)
        return
    }

    fmt.Println("HTTP 状态:", resp.Status)
    fmt.Println("响应内容:", string(body))
}

http.PostForm 内部自动设置 Content-Type 并编码表单,语义清晰、不易出错。

CurlShip Directory Submission
CurlShip Directory Submission

向CurlShip提交产品,这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品,支持OG标签抓取、带徽章的dofollow链接及层级升级。

下载

✅ 方式二:手动构造 http.Request(更灵活,适合进阶控制)

package main

import (
    "bytes"
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

func main() {
    apiUrl := "https://example.com/api/"
    data := url.Values{}
    data.Set("api_token", "MY_KEY")
    data.Set("action", "list_projects")

    // 注意:必须显式设置 Content-Type
    req, err := http.NewRequest("POST", apiUrl, bytes.NewBufferString(data.Encode()))
    if err != nil {
        fmt.Printf("创建请求失败: %v\n", err)
        return
    }
    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Printf("发送请求失败: %v\n", err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Printf("读取响应失败: %v\n", err)
        return
    }

    fmt.Println("HTTP 状态:", resp.Status)
    fmt.Println("响应内容:", string(body))
}

⚠️ 关键注意事项

  • 永远检查 err:网络请求可能因超时、DNS 失败、连接拒绝等失败,忽略 err 会导致程序静默崩溃或逻辑错误。
  • defer resp.Body.Close() 必须在 err == nil 后调用:否则当 resp 为 nil 时会 panic。
  • 避免使用已弃用的 ioutil(Go 1.16+):生产环境建议升级至 io.ReadAll(需 import "io"),ioutil 已被标记为 deprecated。
  • 不要用 strings.NewReader 替代 bytes.NewBufferString:二者功能等价,但 bytes.NewBufferString 更常用于此场景;重点在于 Content-Type 设置,而非 Reader 类型。

掌握这两种方式后,你就能可靠地与绝大多数基于表单的 REST API(如 PHP 后端、传统 Web 框架)完成交互。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php curl dns rest api

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

2023.06.14

3743

6

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

2023.10.30

855

4

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1818

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2864

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6184

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

5989

6

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

2024.03.22

7594

16

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2024.04.29

11354

11

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.07.29

5839

17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习