401 Unauthorized主因是Authorization头格式错误：必须为“Authorization: Bearer sk-xxx”，禁引号、多余空格及键名错误；需显式设置CURLOPT_HTTPHEADER，并检查API密钥末尾有无换行符。
PHP cURL 请求 OpenAI API 时返回 401 Unauthorized
不是密钥没填，大概率是请求头格式错了。OpenAI 要求 Authorization 头必须为 Bearer sk-xxx 格式，且 sk- 前缀不能漏、不能多空格、不能带引号。
常见错误写法：Authorization: "Bearer sk-xxx"（引号会传过去）、Authorization: Bearer sk- xxx（中间空格）、auth: Bearer sk-xxx（键名错）。
正确做法用 curl_setopt($ch, CURLOPT_HTTPHEADER, [...]) 显式设置：
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer ' . $api_key // 注意拼接无引号、无多余空格
]);另外确认 $api_key 是从环境变量或配置文件读取的纯字符串，没被 trim() 意外截断换行符——用 var_dump($api_key) 看一眼末尾有没有 \n。
立即学习“PHP免费学习笔记（深入）”；
json_decode() 返回 null 但 HTTP 状态码是 200
说明响应体不是合法 JSON，最常见原因是 OpenAI 返回了流式响应（stream: true），而你按普通 JSON 解析了 chunk 数据。
检查是否误开了流式开关：请求体里有 "stream": true 就必须逐行解析 data: 前缀的 SSE 格式，不能直接 json_decode($response)。
如果不是故意流式，确保请求体中明确写了："stream": false（默认值，但显式声明更安全）。
其他可能原因：
-
curl_exec()返回false但没检查，导致json_decode(false)→null - OpenAI 返回了错误 JSON（比如字段名拼错），用
json_last_error_msg()查具体哪出问题 - 响应体含 UTF-8 BOM（尤其 Windows 编辑器保存的 config 文件），用
ltrim($response, "\xEF\xBB\xBF")清除
使用 guzzlehttp/guzzle 时抛出 SSL certificate problem
本地开发环境（尤其是 Windows 或 macOS Homebrew PHP）常因 CA 证书路径不对触发此错，不是代理或防火墙问题。
临时解决（仅开发）：->setSslVerification(false) —— 但上线前必须删掉，否则不安全。
正解是让 Guzzle 找到系统 CA 包：
- Linux：通常自动识别，若不行可设
openssl.cafile=/etc/ssl/certs/ca-certificates.crt（路径查php -r "print_r(openssl_get_cert_locations());"） - macOS（MAMP/MacPorts）：CA 文件常在
/opt/local/share/curl/curl-ca-bundle.crt或/usr/local/etc/openssl@3/cert.pem - Windows：下载 cacert.pem，然后在
php.ini加curl.cainfo="C:\path\to\cacert.pem"
验证是否生效：用 curl -v https://api.openai.com/v1/models 看是否还报 SSL 错。
模型返回内容被截断或乱码
两个独立原因：输出编码和 token 限制。
乱码大概率是响应头声明了 Content-Type: application/json; charset=utf-8，但 PHP 输出时被当前脚本编码覆盖（比如文件存成了 GBK）。确保 PHP 文件本身是 UTF-8 无 BOM 编码，并在输出前加 header('Content-Type: text/html; charset=utf-8');（如需网页展示）或统一用 mb_convert_encoding() 处理。
截断则多因 max_tokens 设太小，或 prompt 占用 token 过多，留给 response 的空间不足。用 text-davinci-003 时尤其明显——它总 token 上限是 4097，prompt + completion 不能超。换成 gpt-3.5-turbo 可升至 16384，但也要注意实际消耗（可用 tiktoken-php 库预估）。
别依赖 substr() 截断响应——可能砍在 UTF-8 字节中间，改用 mb_substr($text, 0, 200, 'UTF-8')。
