答案：PHP调用API时请求头错误主因是headers格式不正确、缺少必要字段或cURL配置不当。需使用字符串数组设置header，每项为Header-Name: Header-Value格式，避免空格错误或关联数组；确保包含Content-Type、Authorization、Accept等关键头；CURLOPT_HTTPHEADER必须传数组且避免重复设置；可通过开启CURLOPT_VERBOSE调试查看实际请求头；特殊字符应UTF-8编码或使用英文替代；对照Postman请求可快速定位问题。
PHP调用API时请求头设置错误，通常会导致服务器返回400、401、403或415等状态码，甚至直接拒绝响应。这类问题大多源于headers格式不正确、缺少必要字段或cURL配置不当。以下是常见问题排查方法和正确的cURL headers使用方式。
检查请求头格式是否正确
PHP中使用cURL发送请求时，headers必须以字符串数组的形式传入，每项格式为Header-Name: Header-Value。常见错误包括：
- 使用关联数组而非字符串数组
- 冒号前后有空格错误（如
Content-Type : application/json） - 漏写协议头名称或值
正确示例：
$headers = [ 'Content-Type: application/json', 'Authorization: Bearer your-access-token', 'Accept: application/json' ]; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
确保必需的请求头已包含
不同API对请求头要求不同，常见的关键头包括：
立即学习“PHP免费学习笔记（深入）”；
- Content-Type：指明请求体格式，如JSON、form-data
- Authorization：携带认证信息，如Bearer Token、Basic Auth
- Accept：声明期望的响应格式
- User-Agent：部分API会验证客户端身份
如果缺失这些头，服务器可能返回400或401。建议查阅API文档确认所需headers，并逐项添加。
验证cURL配置是否生效
即使设置了headers，若cURL选项配置错误，也可能导致headers未发送。关键点：
- 确保
CURLOPT_HTTPHEADER接收的是数组，不是字符串 - 避免重复设置导致覆盖（如多次调用
curl_setopt） - 开启cURL调试查看实际请求：
curl_setopt($ch, CURLOPT_VERBOSE, true);
curl_setopt($ch, CURLOPT_STDERR, fopen('php://output', 'w'));
这会输出详细通信过程，可看到实际发送的headers内容。
处理特殊字符与编码问题
若header中包含中文或特殊字符，需确保UTF-8编码并正确转义。例如自定义头带中文：
'X-Client-Info: 用户服务模块'
虽然HTTP标准允许UTF-8，但部分服务端解析可能出错。建议尽量使用英文或URL编码值。
基本上就这些。只要headers格式正确、内容完整、cURL配置无误，大多数请求头问题都能解决。调试时可用Postman对比正常请求，再在PHP中还原相同headers结构，快速定位差异。
