PHP中多表INNER JOIN查询在代码中失效问题排查

你遇到的这个情况真的挺典型的——明明var_dump能看到有效数据，循环次数也对，但json_encode就是没输出，而且去掉某张表的关联就正常。其实核心问题不是字段重复（你已经用别名处理了），而是JSON编码过程中遇到了无法处理的内容，但默认不会抛出错误，咱们一步步排查解决：

1. 先捕获JSON编码的错误信息 #

json_encode失败时只会返回false，不会主动报错，所以第一步必须手动获取错误原因，这能直接帮你定位问题：

$json = json_encode($rows);
if ($json === false) {
    // 打印具体错误信息，比如编码问题、特殊字符等
    echo "JSON编码错误: " . json_last_error_msg();
} else {
    echo $json;
}

常见的错误类型包括：非UTF-8编码字符、二进制数据、特殊数据类型（比如资源）。

2. 优先排查字符编码问题 #

这是最常见的原因：数据库查询结果的编码和PHP输出的编码不一致（比如数据库用GBK，PHP输出用UTF-8），导致json_encode无法处理非UTF-8字符。

解决方法： #

• 连接数据库后立即设置统一字符集（推荐用utf8mb4，支持emoji等特殊字符）：

$conn->set_charset('utf8mb4');

• 如果还是有问题，手动遍历数组把所有字符串转成UTF-8：

function convertToUtf8($data) {
    if (is_array($data)) {
        foreach ($data as $key => $value) {
            $data[$key] = convertToUtf8($value);
        }
    } elseif (is_string($data)) {
        return mb_convert_encoding($data, "UTF-8", "auto");
    }
    return $data;
}
$rows = convertToUtf8($rows);
echo json_encode($rows);

3. 检查二进制字段（比如你的logo字段） #

你查询了itv.logo，如果这个字段是BLOB类型的二进制图片数据，json_encode是无法直接处理二进制内容的，这会直接导致编码失败。

解决方法： #

把二进制数据转成Base64编码后再输出：

while($r = mysqli_fetch_assoc($result)) {
    // 处理logo字段
    if (isset($r['logo']) && !empty($r['logo'])) {
        $r['logo'] = base64_encode($r['logo']);
    }
    $rows[] = $r;
}

或者暂时去掉logo字段的查询，测试是否能正常输出，确认是不是这个字段的问题。

4. 完整的修改示例代码 #

结合上面的排查点，给你整理了一份完整的调试代码：

$sql = " SELECT itv.id AS channel_id, tv_genre.id AS genre_id, services_package.id AS service_package_id, itv.name AS channel_name, itv.descr AS channel_description, services_package.type AS channel_type, itv.number, itv.censored, itv.cmd AS channel_source, tv_genre.title AS genre_name, itv.logo FROM services_package JOIN service_in_package ON services_package.id = service_in_package.package_id JOIN itv ON service_in_package.service_id = itv.id JOIN tv_genre ON itv.tv_genre_id = tv_genre.id WHERE services_package.id =25 ";
$rows = array();
$result = $conn->query($sql);

// 第一步：设置数据库字符集
$conn->set_charset('utf8mb4');

if($result->num_rows > 0) {
    while($r = mysqli_fetch_assoc($result)) {
        // 处理二进制logo字段
        if(isset($r['logo']) && !empty($r['logo'])){
            $r['logo'] = base64_encode($r['logo']);
        }
        $rows[] = $r;
    }
    
    // 第二步：尝试编码并捕获错误
    $json = json_encode($rows);
    if($json === false){
        echo "JSON编码错误: " . json_last_error_msg();
    } else {
        // 设置响应头为JSON格式，前端解析更友好
        header('Content-Type: application/json');
        echo $json;
    }
} else {
    echo json_encode(array('message' => '未查询到数据'));
}

总结 #

你的问题本质是json_encode静默失败，通过json_last_error_msg()就能快速定位原因，大概率是字符编码或者二进制字段的问题，按照上面的步骤排查就能解决。

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