如何用libcurl实现多字段application/x-www-form-urlencoded POST请求？

你的命令行请求使用的是application/x-www-form-urlencoded格式，不需要用到MIME相关API。之前多次设置CURLOPT_POSTFIELDS无效，是因为每次调用都会覆盖之前的设置——这个选项只能一次性传入完整的POST数据字符串。

方法一：手动构造urlencoded格式数据 #

这是匹配你命令行请求的最简方案，步骤如下：

1. 对每个字段的值进行URL编码（对应命令行的--data-urlencode），避免特殊字符破坏请求格式。
2. 将编码后的字段拼接成key=encoded_value&key2=encoded_value2的标准格式。
3. 一次性设置CURLOPT_POSTFIELDS完成请求配置。

示例代码 #

#include <curl/curl.h>
#include <string.h>
#include <stdlib.h>

int main(void) {
  CURL *curl = curl_easy_init();
  if(curl) {
    // 替换为实际业务值
    const char *grant_type = "client_credentials";
    const char *scope = "your_scope";
    const char *client_id = "your_client_id";
    const char *client_secret = "your_client_secret";

    // 对含特殊字符的字段值做URL编码
    char *encoded_scope = curl_easy_escape(curl, scope, 0);
    char *encoded_client_id = curl_easy_escape(curl, client_id, 0);
    char *encoded_client_secret = curl_easy_escape(curl, client_secret, 0);

    // 计算拼接后字符串长度，分配内存
    size_t post_len = strlen("grant_type=") + strlen(grant_type) +
                      strlen("&scope=") + strlen(encoded_scope) +
                      strlen("&client_id=") + strlen(encoded_client_id) +
                      strlen("&client_secret=") + strlen(encoded_client_secret) + 1;
    char *post_data = malloc(post_len);

    if(post_data) {
      // 拼接成完整的urlencoded字符串
      snprintf(post_data, post_len,
               "grant_type=%s&scope=%s&client_id=%s&client_secret=%s",
               grant_type, encoded_scope, encoded_client_id, encoded_client_secret);

      // 配置请求参数
      curl_easy_setopt(curl, CURLOPT_URL, "your_target_url");
      curl_easy_setopt(curl, CURLOPT_POST, 1L);
      curl_easy_setopt(curl, CURLOPT_POSTFIELDS, post_data);

      // 执行请求
      CURLcode res = curl_easy_perform(curl);
      if(res != CURLE_OK)
        fprintf(stderr, "请求失败: %s\n", curl_easy_strerror(res));

      free(post_data);
    }

    // 释放资源
    curl_free(encoded_scope);
    curl_free(encoded_client_id);
    curl_free(encoded_client_secret);
    curl_easy_cleanup(curl);
  }
  return 0;
}

方法二：用curl_mime构造（适配复杂场景） #

如果后续需要发送multipart/form-data格式的请求（比如上传文件、传输二进制数据），才需要用到curl_mime API。针对你当前的需求，用mime也可以实现，代码如下：

示例代码 #

#include <curl/curl.h>

int main(void) {
  CURL *curl = curl_easy_init();
  if(curl) {
    curl_mime *mime = curl_mime_init(curl);

    // 添加各个字段，curl_mime_data会自动处理URL编码
    curl_mimepart *part = curl_mime_addpart(mime);
    curl_mime_name(part, "grant_type");
    curl_mime_data(part, "client_credentials", CURL_ZERO_TERMINATED);

    part = curl_mime_addpart(mime);
    curl_mime_name(part, "scope");
    curl_mime_data(part, "your_scope", CURL_ZERO_TERMINATED);

    part = curl_mime_addpart(mime);
    curl_mime_name(part, "client_id");
    curl_mime_data(part, "your_client_id", CURL_ZERO_TERMINATED);

    part = curl_mime_addpart(mime);
    curl_mime_name(part, "client_secret");
    curl_mime_data(part, "your_client_secret", CURL_ZERO_TERMINATED);

    // 配置请求
    curl_easy_setopt(curl, CURLOPT_URL, "your_target_url");
    curl_easy_setopt(curl, CURLOPT_MIMEPOST, mime);

    // 执行请求
    CURLcode res = curl_easy_perform(curl);
    if(res != CURLE_OK)
      fprintf(stderr, "请求失败: %s\n", curl_easy_strerror(res));

    // 清理资源
    curl_mime_free(mime);
    curl_easy_cleanup(curl);
  }
  return 0;
}

关于MIME的简单解释 #

MIME（多用途互联网邮件扩展）最初用于邮件传输，后来被HTTP借用，用来支持多类型数据传输。multipart/form-data是它的一种应用格式：把每个POST字段封装成独立的“数据块”，每个块有自己的名称和类型标识，适合传输包含二进制内容、大文件或复杂结构的请求。而你当前使用的application/x-www-form-urlencoded是更轻量化的纯文本键值对格式，适合简单的表单提交。

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