PHP数组转JSON失败：json_encode及Slim withJson无输出

我之前也碰到过一模一样的情况，折腾了好一会儿才找到问题所在，给你列几个最常见的排查方向和解决办法：

1. 先确认JSON编码本身是否成功 #

很多时候不是Slim的问题，而是json_encode()本身因为各种原因失败了，却没报错。你可以先单独测试数组转JSON的过程，加上错误检测：

$yourArray = [
    [
        'ID' => 1,
        'Vorname' => 'Firstname',
        'Nachname' => 'Lastname',
        'Geburtsdatum' => '1990-01-01',
        'Email' => 'test@testmail.com',
        'Telefon' => '0511123123'
    ]
];

$json = json_encode($yourArray);
if ($json === false) {
    // 打印具体的编码错误信息
    die('JSON编码失败: ' . json_last_error_msg());
}

如果这里输出错误，比如Malformed UTF-8 characters, possibly incorrectly encoded，那就是数组里的字符串编码不是UTF-8，这是最常见的坑。

2. 处理非UTF-8字符 #

如果数组里的字符串是GBK或者其他编码，json_encode()会直接返回false。可以写个递归函数把整个数组转成UTF-8：

function convertArrayToUtf8($data) {
    if (is_array($data)) {
        foreach ($data as $key => $value) {
            $data[$key] = convertArrayToUtf8($value);
        }
    } elseif (is_string($data)) {
        // 自动检测原编码并转成UTF-8
        return mb_convert_encoding($data, 'UTF-8', mb_detect_encoding($data));
    }
    return $data;
}

// 转码后再用Slim返回
$utf8Array = convertArrayToUtf8($yourArray);
return $response->withJson($utf8Array, 200, JSON_UNESCAPED_UNICODE);

3. 检查是否有提前输出导致响应失效 #

Slim的withJson()需要设置HTTP响应头，如果在return之前有任何输出（比如echo、print，甚至文件开头的BOM字节、空格），都会导致头已经发送，响应无法正常返回。

• 检查你的PHP文件开头有没有多余的空格或者BOM（可以用文本编辑器的“显示所有字符”功能查看）
• 确保路由处理函数里没有提前的echo/print语句
• 如果之前有开启输出缓冲，可以试试在return前清空缓冲：ob_clean();

4. 适配Slim版本的响应写法 #

不同版本的Slim响应写法略有差异：

• Slim 3：直接用return $response->withJson($yourArray);即可，框架会自动处理头
• Slim 4：如果withJson方法不好用，可以手动设置头并输出：

return $response->withHeader('Content-Type', 'application/json')
                ->write(json_encode($utf8Array, JSON_UNESCAPED_UNICODE));

按照这几步排查，应该能解决无输出的问题。

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