curl中如何设置多个Header值？

Question

在使用 `curl` 发起HTTP请求时，如何正确设置多个自定义Header（如认证信息、内容类型等）是开发者常遇到的问题。常见的疑问是：是否可以用一个 `-H` 参数传递多个头字段？如果使用多个 `-H` 选项，它们是否会叠加生效？例如，同时设置 `Authorization: Bearer token` 和 `Content-Type: application/json` 时，语法格式是否正确？此外，在 Shell 脚本中拼接多个 Header 时，引号处理不当是否会导致解析错误？这些问题直接影响请求能否被服务器正确接收和解析。

Answer 1

在使用 curl 发起 HTTP 请求时正确设置多个自定义 Header 的完整指南

1. 基础语法：单个与多个 -H 参数的使用

在 curl 中，每个自定义 HTTP 头部必须通过独立的 -H（或 --header）参数指定。例如：

curl -H "Content-Type: application/json" \
     -H "Authorization: Bearer your-token-here" \
     https://api.example.com/data

上述命令会成功发送两个头部字段到服务器。值得注意的是，不能在一个 -H 参数中传递多个头字段，如下写法是错误的：

# ❌ 错误示例：一个 -H 包含多行头部
curl -H "Content-Type: application/json
Authorization: Bearer token" https://api.example.com

这会导致 shell 解析失败或 curl 将其视为单一无效头部。

2. 多个 -H 参数是否叠加生效？

答案是肯定的。curl 支持重复使用 -H 选项，所有指定的头部将被合并并附加到请求中。执行以下命令：

curl -H "X-Client-Version: v1.2" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer abc123xyz" \
     -X POST -d '{"name":"test"}' https://api.example.com/users

该请求将包含全部三个自定义头部。可通过抓包工具（如 Wireshark 或 tcpdump）验证实际发出的 HTTP 请求头内容。

3. Shell 脚本中的引号处理与变量拼接风险

在编写自动化脚本时，开发者常尝试动态构建头部列表。若引号处理不当，极易导致解析异常。例如：

# ❌ 危险做法：字符串拼接可能导致空格分割错误
headers="Content-Type: application/json Authorization: Bearer $TOKEN"
curl -H "$headers" https://api.example.com # 实际只传了一个错误头部

推荐做法是使用数组存储多个头部：

# ✅ 安全做法：使用 Bash 数组管理多头部
declare -a headers=(
    "Content-Type: application/json"
    "Authorization: Bearer $TOKEN"
    "X-Request-ID: $(uuidgen)"
)

curl "${headers[@]/#/-H }" -X GET https://api.example.com/data

此方式确保每个头部独立传递，避免 shell 字符分割问题。

4. 特殊字符与编码注意事项

当 Token 或其他头部值包含特殊字符（如冒号、引号、空格），需进行 URL 编码或合理引用。例如：

• Bearer Token 含 Base64 字符串通常无需额外编码
• 若使用自定义认证方案含空格，应整体用双引号包裹
• 避免在头部值中直接插入未转义换行符

测试时可添加 -v 参数查看详细请求头输出：

curl -v \
     -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
     -H "Content-Type: application/json" \
     https://api.example.com/secure-endpoint

5. 高级技巧：配置文件与环境变量集成

对于复杂项目，可将常用头部写入配置文件，并通过脚本加载。例如创建 ~/.curl_headers：

# ~/.curl_headers
Header: Content-Type: application/json
Header: User-Agent: MyApp/1.0
Header: X-API-Key: ${API_KEY}

然后结合环境变量调用：

export API_KEY="sk-live-xxx123"
curl --config ~/.curl_headers https://api.example.com/v2/data

这种方式提升可维护性，尤其适用于 CI/CD 环境。

6. 常见错误与调试流程图

graph TD A[开始发送 curl 请求] --> B{是否使用多个 -H?} B -- 是 --> C[每个 -H 是否独立声明?] B -- 否 --> D[改为多个 -H 参数] C -- 否 --> E[拆分为独立 -H] C -- 是 --> F{Shell 脚本中使用变量?} F -- 是 --> G[检查引号和数组用法] F -- 否 --> H[添加 -v 查看请求头] G --> H H --> I{服务器返回 400/401?} I -- 是 --> J[确认头部名称大小写及值格式] I -- 否 --> K[请求成功]

7. 表格对比：正确 vs 错误用法

场景	错误写法	正确写法
多个头部	-H "A: x B: y"	-H "A: x" -H "B: y"
变量注入	-H 'Auth: Bearer $TOK'	-H "Auth: Bearer $TOK"
脚本传参	curl $HEADERS url	curl "${hdrs[@]/#/-H }" url
保留原始大小写	-H "content-type: ..."	-H "Content-Type: ..."