json_decode() 返回 null 表示解析失败而非接口报错，主因是输入数据非法（如html、空响应、bom、控制字符），需用 json_last_error() 或 json_throw_on_error 检测，并清洗原始响应后验证。
json_decode() 返回 null 就是解析失败，不是“接口报错”，而是输入数据本身不合法
为什么 json_decode() 总是返回 null
PHP 的 json_decode() 在遇到任何非法输入时都静默返回 null，不抛异常、不打印 warning。你看到的“文生图接口报错”，大概率是下游返回了非 JSON 内容（比如 HTML 错误页、空响应、带 BOM 的 UTF-8 字符串、或混入控制字符），但代码没检查就直接用了 null，后续访问字段时才爆出 Notice 或 Fatal。
- 常见现象：API 返回 401/404 页面（HTML）、CORS 拦截后返回空字符串、Nginx 配置错误返回 502 HTML、HTTPS 证书问题导致
file_get_contents()返回false，再传给json_decode() - 必须在调用
json_decode()后立刻查json_last_error()，不能只靠=== null判断 -
json_last_error()是全局状态，中间若调了其他 JSON 函数（如日志里写了json_encode()），结果会被覆盖
怎么定位到底是哪出的问题
别急着改代码，先确认原始响应内容是否真的是 JSON：
- 用
var_dump($rawResponse)看原始字符串，注意有没有 HTML 标签、/code>、<code> 或乱码 - 用
mb_detect_encoding($rawResponse, ['UTF-8', 'ASCII'], true)粗略看编码；再用ltrim($rawResponse, "\xEF\xBB\xBF")去 BOM - 用
preg_replace('/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/u', '', $rawResponse)清理非法控制字符（尤其 U+2028/U+2029） - 把
$rawResponse复制到 jsonlint.com 或命令行跑echo '$rawResponse' | python3 -m json.tool验证语法
推荐的健壮解析写法（含清洗 + 异常）
PHP 7.3+ 环境下，优先用 JSON_THROW_ON_ERROR，配合清洗和长度限制：
$raw = file_get_contents('php://input');
if ($raw === false) {
throw new RuntimeException('HTTP request failed');
}
if (strlen($raw) > 2 * 1024 * 1024) { // 2MB 上限
throw new InvalidArgumentException('Payload too large');
}
$clean = ltrim($raw, "\xEF\xBB\xBF");
$clean = preg_replace('/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/u', '', $clean);
try {
$data = json_decode($clean, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
throw new InvalidArgumentException('Invalid JSON: ' . $e->getMessage());
}
- 第三个参数
$depth默认 512，文生图接口若返回超深嵌套结构（如带完整 prompt history 的数组），需按需调高 - 不要省略
true参数——不加它返回的是stdClass对象，后续用$data['result']会报错 -
JSON_THROW_ON_ERROR只对json_decode()生效，不影响json_encode()
最容易被忽略的点
文生图接口返回的 JSON 通常体积大、结构深、含大量 base64 图片字段，这些特性会放大所有解析隐患：
- base64 字符串中可能含换行符或空白，某些 SDK 生成的 JSON 会把它格式化成多行，而 PHP 的
json_decode()要求严格单行字符串（除非你手动str_replace(["\r\n", "\n", "\r"], '', $raw)） - 大 JSON 容易触发
memory_limit，但错误表现仍是null+JSON_ERROR_SYNTAX（因为内存不足时解析器提前终止） - 部分文生图服务返回的 “success” 字段是字符串
"true"而非布尔true，若你依赖该字段做判断，记得用filter_var($data['success'], FILTER_VALIDATE_BOOLEAN)转换
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
