PHP MySQL JSON API问题排查：仅单个分类数据可正常返回

这种情况我之前开发类似Android后端API时也踩过坑，咱们一步步拆解可能的原因和排查方法：

1. 先抓出JSON编码的真实错误 #

很多时候看似“空白输出”，其实是json_encode()执行失败返回了false，只是你没看到错误提示。可以在编码后立刻加错误检查：

// 假设$categoryData是你从数据库组装好的待转数组
$jsonOutput = json_encode($categoryData, JSON_UNESCAPED_UNICODE | JSON_PARTIAL_OUTPUT_ON_ERROR);

if ($jsonOutput === false) {
    // 打印具体错误，直接定位问题
    die('JSON编码失败: ' . json_last_error_msg());
}

// 正常输出JSON
header('Content-Type: application/json');
echo $jsonOutput;

加JSON_PARTIAL_OUTPUT_ON_ERROR参数后，即使有部分数据编码失败，也会输出能正常处理的内容，更容易找到出问题的字段。

2. 检查字符编码一致性（最常见原因） #

如果某些分类的数据里包含非UTF-8字符，json_encode()会直接罢工：

• 数据库连接时强制用utf8mb4（支持emoji和全量中文），连接后加：

  mysqli_set_charset($dbConnection, 'utf8mb4');
  

• 确认数据库表、对应字段的编码也是utf8mb4，避免数据入库时就产生乱码。

3. 对比正常/异常分类的数据差异 #

既然数据库查询都正常，把两类数据打印出来对比：

// 在转JSON前，先打印原始查询结果
var_dump($categoryData);
exit;

重点看异常分类的数据有没有这些特殊情况：

• 包含不可见控制字符（比如\x00这类ASCII控制符）
• 字段值为NULL但处理逻辑没兼容（虽然json_encode能处理NULL，但极端场景可能出问题）
• 超长文本、二进制数据（比如某些字段存了大段富文本、图片二进制流）

如果发现这类值，可以提前处理：比如用preg_replace('/[\x00-\x1F\x7F]/u', '', $value)清理控制字符，或者对超长文本做截断。

4. 检查数组组装逻辑 #

会不会是你构建$categoryData数组时，只有某个分类的逻辑是对的？比如：

• 是不是写了if ($categoryId == 1)这种硬编码判断，只给特定分类组装数据？
• 循环查询结果时，有没有在某些分类下提前break/return，导致数组没被填满？
• 某些分类的查询结果本身是空数组，但你没做空数据提示，直接输出了空JSON（这种情况其实是正常的，但容易被误以为是“空白”）

5. 排查输出缓冲区干扰 #

有时候PHP脚本在输出JSON前，可能已经偷偷输出了空白字符、空格或者警告信息（比如之前的echo调试代码、PHP的Notice警告），这些内容会破坏JSON结构，看起来像是“空白输出”。

解决方法：

• 脚本开头开启输出缓冲：ob_start();
• 输出JSON前清空缓冲区：ob_clean();
• 临时开启错误显示，排查隐藏警告：

  error_reporting(E_ALL);
  ini_set('display_errors', 1);
  

按这个顺序排查，应该能很快定位到问题。

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