ThinkPHP缓存序列化失败因含闭包、资源或不可序列化对象，需自定义驱动过滤或改用JSON序列化；Redis推荐配置'serialize'=>'json'，File驱动可重写serialize/unserialize方法跳过不可序列化值。
ThinkPHP 缓存驱动序列化失败的典型报错
当你在 ThinkPHP（尤其是 5.1/6.x）中使用 File、Redis 或 Memcached 缓存驱动时，如果缓存值是含闭包、资源句柄、不可序列化对象（如 PDO 实例、Closure、mysqli）的数据结构，会直接抛出类似：Serialization of 'Closure' is not allowed 或 Exception: Serialization of 'PDO' is not allowed 的致命错误。
这不是缓存驱动本身的问题，而是 ThinkPHP 默认调用 serialize() 存储数据，而 PHP 原生序列化机制明确禁止序列化某些类型。常见触发场景包括：
- 把整个
Request对象或Response对象塞进缓存 - 缓存了带回调函数的配置数组（例如含
function () {}或[$obj, 'method']） - 使用了第三方 SDK 返回的未做净化的实例（如某些支付/短信 SDK 的 client 对象）
如何让缓存自动跳过不可序列化字段
ThinkPHP 本身不提供“自动过滤”机制，但你可以通过重写缓存驱动的 set() 方法实现安全序列化。核心思路是：在序列化前用 is_serializable()（PHP 8.2+）或自定义检测逻辑预判，对不可序列化的值转为 null 或字符串标记。
以自定义 File 驱动为例，在 app/common/cache/SerializableFile.php 中扩展：
立即学习“PHP免费学习笔记（深入）”；
namespace app\common\cache;
use think\cache\driver\File;
class SerializableFile extends File
{
protected function serialize($data)
{
if (is_object($data) && method_exists($data, '__sleep')) {
// 允许对象主动声明可序列化字段
return parent::serialize($data);
}
// 粗粒度过滤：跳过 Closure、Resource、PDO 等
if (is_object($data) || is_resource($data)) {
$type = gettype($data);
if ($type === 'object') {
$class = get_class($data);
if (in_array($class, ['Closure', 'PDO', 'mysqli'], true)) {
return 'UNSERIALIZABLE:' . $class;
}
}
return 'UNSERIALIZABLE:' . $type;
}
return parent::serialize($data);
}
protected function unserialize($data)
{
if (is_string($data) && str_starts_with($data, 'UNSERIALIZABLE:')) {
return null;
}
return parent::unserialize($data);
}
}
然后在 config/cache.php 中指定驱动：
'default' => [
'type' => 'app\common\cache\SerializableFile',
// 其他配置...
],
Redis 驱动下更推荐用 JSON 替代 serialize
Redis 本身不依赖 PHP 序列化，用 json_encode() 更安全、跨语言、体积小，且天然跳过资源和闭包（会直接报错，便于早期发现）。ThinkPHP 6.x 支持自定义序列化处理器，只需在 Redis 配置中加一项：
'redis' => [
'type' => 'redis',
'host' => '127.0.0.1',
'port' => 6379,
'serialize' => 'json', // ← 关键：设为 'json'
],
注意：json 模式下以下类型会被静默丢弃或转换：
-
float类型精度可能丢失（PHP 默认 JSON 不保留尾随零） -
NaN、INF会变成null - 资源、对象（非 StdClass）、闭包会触发
json_encode()失败 → 缓存写入失败，需配合try/catch或前置清洗 - 中文等 UTF-8 字符正常，无需额外处理
若必须缓存对象，建议统一转成 array 或 stdClass 再存，例如：
Cache::set('user_info', $user->toArray(), 3600); // 而不是 $user 实例本身
为什么不要在应用层手动 serialize/unserialize
有些开发者会在存缓存前自己调用 serialize()，取的时候再 unserialize()，这看似可控，实则埋雷：
- ThinkPHP 的
TaggedCache、Cache::remember()等高级接口会绕过你的手动封装，仍走默认序列化流程 - 不同驱动（如
FilevsRedis）对序列化格式要求不一致，混用易导致读取乱码或解析失败 - PHP 7.4+ 启用
unserialize_callback_func限制后，反序列化失败不再报错而是返回false，问题更隐蔽 - 安全风险：不受控的
unserialize()是反序列化漏洞高发区，尤其当缓存内容可能被污染时
真正需要兼容多种数据结构时，别碰裸序列化 —— 要么清洗数据结构（只存数组/标量），要么换存储方案（如用数据库存复杂对象，缓存只存 ID）。序列化从来不是缓存的必经之路，只是历史包袱下的惯性选择。
