JsonSerializable接口仅定义json_encode()时的输出数据，不负责写入文件；常见失败原因包括非UTF-8字符、循环引用、返回不可序列化类型，需检查json_last_error()并用file_put_contents()手动写入。
JsonSerializable 接口不是“把对象转成 JSON 文件”的快捷键，它只负责定义对象在 json_encode() 时该输出什么数据。想写入文件，得自己调用 file_put_contents()。
为什么实现了 JsonSerializable 还是得不到预期 JSON？
常见原因是 json_encode() 返回 false，但没检查错误。这通常由以下情况导致：
-
json_last_error()返回JSON_ERROR_UTF8：对象里有非 UTF-8 字符（比如 GBK 编码的字符串） - 返回
JSON_ERROR_RECURSION：jsonSerialize()方法里不小心引用了自身或循环嵌套的对象 - 返回
JSON_ERROR_TYPE：jsonSerialize()返回了资源（resource）、闭包（closure）或不可序列化的类型
jsonSerialize() 方法里该 return 什么？
必须返回一个能被 json_encode() 直接处理的值：数组、标量、null，或实现了 JsonSerializable 的其他对象。不能 return $this（除非你明确要递归序列化）。
示例：
立即学习“PHP免费学习笔记（深入）”；
class User implements JsonSerializable {
public $name = '张三';
private $id = 123;
private $password = 'xxx';
public function jsonSerialize() {
return [
'id' => $this->id,
'name' => $this->name,
// 不暴露 password
];
}
}
echo json_encode(new User()); // {"id":123,"name":"张三"}
怎么把对象真正写进 JSON 文件？
分两步：先 json_encode() 得到字符串，再用 file_put_contents() 写入。别跳过错误检查。
- 加
JSON_UNESCAPED_UNICODE避免中文变 \uXXXX - 用
JSON_PRETTY_PRINT方便调试（但生产环境慎用，体积大） - 确保目标目录可写，否则
file_put_contents()返回false
实操写法：
$user = new User();
$json = json_encode($user, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
if ($json === false) {
throw new RuntimeException('JSON encode failed: ' . json_last_error_msg());
}
if (file_put_contents('user.json', $json) === false) {
throw new RuntimeException('Failed to write file user.json');
}
最容易被忽略的是：接口只管“怎么转”，不负责“转哪去”；而 json_encode() 的静默失败（返回 false 而非抛异常）会让问题卡在黑盒里很久。
