PHP调用Watson API必须用cURL：因需严格IAM认证、POST JSON、处理401/400错误，file_get_contents易丢响应头和错误信息；须显式设置cURL选项、检查返回值、手动管理token与session，并安全解析不统一的错误响应。
PHP调用Watson API必须用cURL而非file_get_contents
IBM Watson的API要求严格的身份认证（IAM token或API key），且多数端点需要POST带JSON body、Content-Type: application/json，并返回含401或400的详细错误。用file_get_contents配stream_context_create极易漏掉响应头、吞掉错误信息，调试时只能看到bool(false)。
实操建议：
- 始终用
curl_init()，显式设置CURLOPT_RETURNTRANSFER => true和CURLOPT_HEADER => false - 必须检查
curl_exec()返回值是否为false，再用curl_error()和curl_getinfo($ch, CURLINFO_HTTP_CODE)定位问题 - Watson Natural Language Understanding等服务对
Accept头敏感，需手动加Accept: application/json - Token过期是高频错误，
401 Unauthorized响应体里通常含"error": "invalid_token"，别直接重试，先刷新token
获取IAM token要用POST /identity/token，不是GET
Watson服务（如Assistant、NLU）不再支持基础认证（username/password），强制走IBM Cloud IAM流程。很多人误以为像旧版Bluemix那样用https://iam.cloud.ibm.com/identity/token?apikey=xxx就能GET拿到token，实际会返回405 Method Not Allowed。
正确做法：
立即学习“PHP免费学习笔记（深入）”；
- 向
https://iam.cloud.ibm.com/identity/token发POST请求，body为grant_type=urn%3Aibm%3Aparams%3Aoauth%3Agrant-type%3Aapikey&apikey=YOUR_API_KEY - Header必须含
Content-Type: application/x-www-form-urlencoded和Accept: application/json - 响应是JSON，从中取
access_token字段（注意它带Bearer前缀，调用Watson API时要原样带上） - token有效期默认1小时，PHP中建议缓存到
apcu_store()或Redis，键名含api_key_hash和过期时间戳
Assistant v2 API的session管理必须自己维护
Watson Assistant v2（推荐用于新项目）不自动绑定session，/message端点要求每次请求都传session_id。PHP里没全局状态，容易在多用户并发时混用session，导致对话错乱或404 Not Found（session已过期或不属于当前用户）。
关键处理点：
- 首次调用
/v2/assistants/{assistant_id}/sessions创建session，响应里的session_id必须存在用户上下文（如$_SESSION['watson_session_id']或JWT payload） - 后续
/message请求的URL必须拼上该session_id，例如/v2/assistants/{id}/sessions/{session_id}/message - session默认30分钟无操作失效，PHP需在每次交互后更新
$_SESSION的最后活跃时间，超时则主动调DELETE /sessions/{id}清理 - 不要把
session_id硬编码或存在配置文件里——每个用户独立session是硬性要求
错误响应体结构不统一，解析前必须检查status code
Watson不同服务返回错误格式差异大：Natural Language Classifier返回{"error":"Not Found"}，而Speech to Text可能返回纯文本Invalid credentials，Assistant v2又用{"error":{"description":"Session not found"}}。直接json_decode($resp, true)再取['error']会出错。
安全解析方式：
- 先用
curl_getinfo($ch, CURLINFO_HTTP_CODE)判断是否>= 400 - 再检查响应头
Content-Type是否含application/json，否则当字符串处理 - 对JSON错误体，统一用
json_last_error() === JSON_ERROR_NONE校验后再取字段 - 记录完整
$http_code、$header、$body到日志，尤其429 Too Many Requests时要提取Retry-After头做退避
真正卡住的往往不是API调用本身，而是token续期逻辑没覆盖边界条件、session生命周期和PHP session机制没对齐、或者把不同Watson服务的错误结构当成一回事来处理。这些地方一旦出问题，日志里只留一行空响应，得靠提前埋好的curl_getinfo和http_code快照才能快速定位。
