腾讯混元API调用失败时必须从原始响应体提取RequestId定位问题：第一步捕获完整未截断响应体；第二步验证是否为合法JSON；第三步逐层解析Response对象获取RequestId字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API调用失败时，必须从原始响应体中提取 RequestId 才能准确定位问题，直接看报错文字或日志摘要往往找不到关键线索。错误响应结构固定，但RequestId藏在嵌套JSON最深层，手动解析容易漏掉。
从完整HTTP响应体里定位RequestId
第一步：确保你捕获的是完整的、未被截断的原始响应体（不是print(e)或str(e)的简化输出）。
第二步：检查响应是否为合法JSON。若返回的是纯文本（如“Invalid JSON”），说明请求根本没到达混元服务端，此时无RequestId，应先查网络或签名问题。
第三步：对JSON响应执行逐层解析——先取Response对象，再取其下的RequestId字段。常见错误是只读Error.Message而跳过外层Response包装。
这一步操作起来很简单，直接把文件拖进去就行。
Python SDK中自动提取RequestId的写法
方法一：使用try-except捕获TencentCloudSDKException，其异常对象自带request_id属性：
```python
try:
resp = client.ChatCompletions(req)
except TencentCloudSDKException as e:
print(f"RequestId: {e.request_id}")
print(f"Error Code: {e.code}")
print(f"Message: {e.message}")
```
方法二：若已拿到原始响应字符串（如调试时用curl或requests抓包），用json.loads后按路径取值：
```python
import json
raw_resp = '{"Response": {"Error": {"Code": "AuthFailure.SignatureFailure", "Message": "The provided credentials could not be validated."}, "RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"}}'
data = json.loads(raw_resp)
request_id = data.get("Response", {}).get("RequestId")
```
【注意】data["Response"]["RequestId"]这种硬编码写法会因Key缺失直接抛KeyError，务必用.get()链式防护。
非SDK调用（如curl/Postman）时手动查找
① 发送请求后，将完整返回内容复制到JSON格式化工具（如json.cn）中展开；
② 展开Response → 查找RequestId字段（它与Error同级，不是Error的子字段）；
③ 若响应体开头是或{"code":xxx}等非标准结构，说明请求被网关拦截或重定向，此时RequestId不存在，需检查Endpoint是否为hunyuan.tencentcloudapi.com且协议为HTTPS；
④ 若返回空响应或Connection reset，RequestId必然为空，问题出在网络层或DNS解析，与认证无关。
