在当今的 API 开发和系统集成中，能够通过命令行工具快速测试接口是每位开发者必备的技能。你是否遇到过需要在没有前端界面的情况下向服务器提交复杂数据的情况？或者，你是否在自动化脚本中需要调用 RESTful API？
在这篇文章中，我们将深入探讨如何使用 curl 这一强大的命令行工具来发送 JSON 数据。我们将不仅仅局限于基本的命令，还会深入讲解服务器端的搭建、多种数据发送方式的对比、常见错误的排查以及实际工作中的最佳实践。让我们开始这段技术探索之旅，通过一个个实际的例子，掌握高效使用 curl 的技巧。
认识 Curl：开发者的瑞士军刀
首先，让我们确保对 INLINECODEa113e5c1 有一个统一的认识。INLINECODEae1369f7（Client for URLs）不仅仅是一个简单的下载工具，它是一个利用 URL 语法进行数据传输的命令行工具和库。它支持包括 HTTP、HTTPS、FTP、SFTP 等在内的多种协议，几乎涵盖了互联网上所有的数据传输需求。由于它通常预装在 Linux、macOS 和 Windows 10/11 系统中，它成为了开发者进行网络请求调试的首选工具。
在使用 curl 发送数据时，我们会频繁使用到以下几个核心选项。在深入 JSON 发送之前，让我们先快速了解一下它们：
- INLINECODEe3f7051d (或 INLINECODE7f6c7e40): 此选项允许我们指定自定义的请求方法。虽然 curl 默认会根据特定选项（如 INLINECODE6b996cce）自动推断为 POST，但明确指定 INLINECODE1168d532、INLINECODEf0a279e0 或 INLINECODE50332a53 可以让命令更具可读性。
- INLINECODE3f599f0d (或 INLINECODE8f72bec6): 用于添加 HTTP 请求头。在发送 JSON 时，我们必须告诉服务器我们正在发送的是 JSON 格式，这就需要用到这个选项来设置
Content-Type。 - INLINECODE688d5567 (或 INLINECODE2061ff95): 这是发送数据的经典选项。它会将数据包含在 HTTP 请求体中。如果不指定 Content-Type，curl 默认会将其设置为
application/x-www-form-urlencoded，这在处理 JSON 时需要特别注意。 -
-o: 将服务器的响应保存到文件中，这在调试需要下载文件或保存日志时非常有用。 -
-u: 用于处理需要基本身份验证的接口。
为什么 JSON 如此重要？
在代码示例中，我们将频繁使用 JSON（JavaScript Object Notation）。作为一种轻量级的数据交换格式，JSON 已经成为了 Web API 的通用语言。相比于旧的 XML 格式，JSON 更加简洁、易于人类阅读，并且能够被 JavaScript 及大多数现代后端语言原生解析。
一个典型的 JSON 数据结构如下所示：
{
"username": "example_user",
"password": "P@ssw0rd123"
}
搭建测试环境：Node.js 服务器
为了演示 curl 是如何工作的，我们需要一个能够接收请求并给予反馈的服务器。仅仅谈论命令而不看结果是不够的。让我们使用 Node.js 和 Express 框架来快速搭建一个简单的登录接口。
这个服务器将监听 5050 端口，并检查用户发送的 INLINECODEb377f186 和 INLINECODE8c5dbb0c 是否相同（这仅用于演示逻辑，实际生产环境请勿这样做）。
#### 准备工作
首先，我们需要创建一个新的项目文件夹并初始化项目：
npm init -y
#### 步骤 1：安装依赖
我们需要安装 INLINECODE7f26fb6c 来处理路由，以及 INLINECODEf8f4daaf 来帮我们在代码修改时自动重启服务器。
npm install express
npm install --save-dev nodemon
#### 步骤 2：编写服务器代码
创建一个名为 INLINECODE67b9c2a8 的文件，并填入以下代码。这段代码定义了一个 INLINECODEc3f7a47d 端点，它会解析请求体中的 JSON 数据，并根据业务逻辑返回状态码和消息。
// 引入 Express 框架
const express = require(‘express‘);
const app = express();
// 中间件：用于解析 JSON 格式的请求体
// 如果不加这一行，req.body 将会是 undefined
app.use(express.json());
// 定义 POST 路由 /login
app.post(‘/login‘, (req, res) => {
// 从请求体中解构获取 username 和 password
const { username, password } = req.body;
console.log("收到请求:", req.body);
// 简单的逻辑验证：检查用户名是否等于密码
if (username === password) {
res.status(200).send("User login Successfully");
} else {
res.status(401).send("User not Logging ");
}
})
// 服务器监听 5050 端口
app.listen(5050, () => {
console.log("Server is Running at http://localhost:5050");
})
#### 步骤 3：启动服务器
在 package.json 中添加启动脚本，或者直接运行：
nodemon server.js
方法一：使用经典的 INLINECODE90993a72 或 INLINECODE7a966eb1 选项
这是最传统也是最广泛支持的方法。使用 INLINECODE62a503bc 选项发送数据时，我们需要显式地告诉服务器请求体是 JSON 格式。这是通过添加 INLINECODEd28cfd2f 头部来实现的。
#### 基本示例
让我们尝试发送一个成功的登录请求。注意，我们在 shell 中使用单引号包裹 JSON 字符串，这样可以避免 shell 对双引号进行转义或解析。
curl -X POST -H "Content-Type: application/json" \
-d ‘{"username":"admin","password":"admin"}‘ \
http://localhost:5050/login
代码解析：
-
-X POST: 明确指定这是一个 POST 请求。 - INLINECODEa862d89b: 关键步骤。如果不加这个，Express 的 INLINECODEf561ffbb 中间件可能无法正确解析数据，导致
req.body为空。 -
-d ‘...‘: 发送的实际数据。
预期输出：
User login Successfully
#### 错误排查示例
为了看看错误情况，我们可以发送一组不匹配的数据。这对于调试非常有用。
curl -X POST -H "Content-Type: application/json" \
-d ‘{"username":"user1","password":"123456"}‘ \
http://localhost:5050/login
预期输出：
User not Logging
方法二：从文件发送 JSON 数据
在实际开发中，JSON 数据往往非常复杂（例如包含嵌套对象或数组），直接在命令行中书写不仅容易出错，而且难以维护。这时，我们可以将 JSON 数据保存在文件中，并通过 curl 引用该文件。
#### 准备数据文件
创建一个名为 data.json 的文件：
{
"username": "admin",
"password": "admin"
}
#### 执行命令
使用 @ 符号告诉 curl 读取文件内容作为数据体：
curl -X POST -H "Content-Type: application/json" \
-d @data.json \
http://localhost:5050/login
实用见解： 当你使用 CI/CD 流水线或进行大规模测试时，这种方法非常强大。你可以为不同的测试场景（注册、登录、支付）准备不同的 JSON 文件，然后在脚本中灵活调用它们。
方法三：使用现代化的 --json 选项
如果你使用的是 curl 7.82.0 或更高版本，你可以享受 --json 选项带来的便利。这是一个专门为发送 JSON 数据设计的简化选项。
#### 为什么它更好？
--json 选项会自动帮你做三件事：
- 将数据序列化为 JSON 字符串。
- 设置
Content-Type: application/json请求头。 - 如果数据来自文件，它还会自动添加
Accept: application/json（在某些场景下有助于服务器响应格式协商）。
#### 示例代码
我们可以省略 INLINECODE35da5aa4 参数，直接发送数据。注意：这种方式下，如果不使用文件，我们在终端输入 JSON 时通常不需要加单引号，或者需要根据系统 shell 调整引号。但在大多数 Bash 环境中，为了安全起见，依然建议处理引号问题。不过，INLINECODE351f5e37 对内部 JSON 字符串的处理更加智能。
curl -X POST --json ‘{"username":"admin","password":"admin"}‘ http://localhost:5050/login
或者从文件读取：
curl -X POST --json @data.json http://localhost:5050/login
高级技巧与最佳实践
掌握了基本用法后，让我们来看看一些能让你的工作流更加顺畅的高级技巧。
#### 1. 美化输出：JQ 的使用
API 返回的 JSON 往往是压缩在一行的，难以阅读。我们可以利用管道将结果传递给 jq 工具进行格式化。
curl -X POST http://localhost:5050/login -d @data.json | jq .
(注意：如果你的服务器返回的是纯文本字符串如 "User login Successfully"，jq 可能会报错，因为它期望 JSON 对象。这主要适用于返回 JSON 对象的 API)
#### 2. 查看详细的请求头：-v 选项
当你发送请求出错，但不知道原因时，-v (verbose) 是你的救命稻草。它会打印出完整的握手信息、请求头和响应头。
curl -v -X POST http://localhost:5050/login -d ‘{"test":"value"}‘
在输出中，你可以看到服务器是否正确接收到了 Content-Length，或者服务器返回了什么具体的错误状态码（如 404, 500）。
#### 3. 处理复杂嵌套与转义
在命令行中直接传递 JSON 时，转义双引号是最头疼的问题。
错误的写法（可能导致 shell 解析错误）：
curl -d {"name": "John"} ...
正确的写法（使用单引号包裹整个 JSON）：
curl -d ‘{"name": "John"}‘ ...
或者在 Git Bash / Windows 环境下，可能需要转义内部的双引号：
curl -d "{\"name\": \"John\"}" ...
这也是为什么我们强烈推荐使用 -d @file.json 的原因——它彻底避免了转义的烦恼。
常见错误与解决方案
在与 curl 和 JSON 打交道时，你可能会遇到以下常见问题：
-
SyntaxError: Unexpected token ... in JSON at position 0:
这通常意味着服务器收到了无效的 JSON。检查你的 JSON 语法，特别是逗号和括号。或者，你可能忘记发送 Content-Type: application/json 头部，导致服务器（如 Express）没有解析 body，从而尝试将纯文本当作 JSON 解析。
-
415 Unsupported Media Type:
服务器拒绝处理你的数据格式。这通常是因为缺少 -H "Content-Type: application/json"。
-
400 Bad Request:
发送的 JSON 格式完全正确，但数据内容不符合服务器的要求（例如缺少必填字段）。请使用 -v 查看服务器返回的具体错误信息，或者检查 JSON 的键名拼写是否正确。
总结
通过这篇文章，我们从零开始搭建了一个 Node.js 服务器，并学习了三种使用 curl 发送 JSON 数据的核心方法：
- 使用 INLINECODEb92b7493 或 INLINECODE7702427e 配合自定义
Content-Type头部，这是最通用、兼容性最强的方法。 - 使用
@filename从文件读取数据，这是处理复杂数据结构的最佳实践。 - 使用
--json选项（适用于新版 curl），这是最简洁、现代化的方式。
此外，我们还探讨了如何通过 -v 调试请求以及如何避免常见的转义错误。希望这些知识能帮助你在日常开发和 API 调试中更加得心应手。下一次，当你需要测试一个新的 API 接口时，不妨打开终端，试试这些强大的命令吧！