XAMPP+PHP集成OpenAI API返回结果与问题无关的排查求助

1. 核对API请求参数格式 #

OpenAI Chat类模型（gpt-3.5-turbo、gpt-4等）要求请求体必须包含messages数组，每个元素需指定role（user/system/assistant）和content字段。如果误用旧版Completion API的prompt参数，或messages结构错误，API会返回无关内容。

错误示例：

$data = [
    'model' => 'gpt-3.5-turbo',
    'prompt' => $_POST['question'] // 该参数仅适用于Completion API
];

正确示例：

$data = [
    'model' => 'gpt-3.5-turbo',
    'messages' => [
        ['role' => 'user', 'content' => $_POST['question']]
    ]
];

2. 检查请求头配置 #

必须正确设置两个核心请求头：

• Content-Type: application/json：确保API识别请求格式
• Authorization: Bearer YOUR_API_KEY：验证身份权限

示例curl请求头设置：

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $api_key
];

3. 验证用户输入传递是否正确 #

确认PHP能正确获取前端提交的问题：

• 前端表单的输入框name属性需与PHP中获取的参数名一致（比如$_POST['question']对应<input name="question">）
• 可临时添加var_dump($_POST)输出参数，检查是否拿到了用户实际提问内容

4. 修正响应解析逻辑 #

Chat API的有效返回内容在choices[0].message.content字段，若错误解析旧版Completion API的choices[0].text字段，会导致获取到无关数据。

正确解析示例：

$response = json_decode($response_body, true);
if (isset($response['choices'][0]['message']['content'])) {
    $answer = trim($response['choices'][0]['message']['content']);
} else {
    // 处理API返回错误的情况
}

5. 排除缓存干扰 #

本地测试时可能存在浏览器缓存、XAMPP服务缓存或PHP会话缓存，导致返回旧内容：

• 清空浏览器缓存，或开启隐私模式测试
• 重启XAMPP的Apache和MySQL服务
• 在API请求URL后添加随机参数（如?t=' . time()）避免缓存

6. 验证API账户状态 #

确认你的API密钥有权限访问所选模型，且账户余额充足：

• 用Postman直接发送相同参数的请求，测试API返回是否正常，排除PHP代码之外的问题
• 登录OpenAI后台查看账户额度和API调用记录，确认请求是否正常抵达API服务器

7. 提供核心代码片段 #

如果以上排查均无效，建议提供PHP代码中请求构造、发送、响应解析的核心部分，比如：

• 获取用户输入的代码
• 构造API请求数据的代码
• 发送请求（curl/file_get_contents）的代码
• 解析API返回结果的代码

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