应全程使用 JSON 编解码并做类型断言：缓存数据反序列化失败主因是 serialize/json 混用、Entity 直接缓存、OPCache preload 干扰、APCu 键名截断等，FrankenPHP 下需统一 json_encode/json_decode、禁用 preload、ASCII 化键名、校验类型与长度。
缓存数据反序列化失败，json_decode 返回 null
FrankenPHP 默认启用 OPCache 且严格校验字节码，若缓存项是用 serialize() 存入、却用 json_decode($data, true) 尝试读取，必然返回 null —— 因为 PHP 序列化字符串不是合法 JSON。这种错配在开发环境可能“凑合能跑”，但在 FrankenPHP 的生产模式下会直接暴露。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 统一使用
json_encode()/json_decode($data, true)存取数组类缓存项，避免混用serialize() - 读取后必须校验类型：
is_array($decoded) === false时立即记录日志并触发 fallback 逻辑 - FrankenPHP 中禁用
opcache.enable_cli=1（若通过 CLI 预热缓存），否则 CLI 和 Web SAPI 的 OPCache 行为不一致，导致反序列化上下文错乱
CacheItem::get() 返回对象而非数组，但代码预期是数组
Symfony 缓存抽象层本身不强制数据类型，CacheItem::get() 拿到的值完全取决于你当初 set() 时传了什么。常见陷阱是：控制器里用 $cache->set('user_data', $userArray)，但 $userArray 实际是 Doctrine Entity 对象，而该对象未实现 __serialize() 或含不可序列化属性（如 PDO 连接），导致缓存写入失败或写入的是损坏字符串。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
set()前做显式转换：$cache->set('user_data', json_encode($userArray))，而不是依赖自动序列化 - 不要把 Entity 直接塞进缓存；先用
array_replace_recursive([], $entity->toArray())或 DTO 显式投影 - FrankenPHP 下检查
php.ini是否禁用了unserialize_callback_func（默认禁用），这会导致自定义反序列化器失效
FrankenPHP 的 opcache.preload 干扰缓存反序列化
Preload 会提前加载并编译类定义，但如果预加载的类与运行时反序列化的类定义存在微小差异（比如命名空间别名、trait 引入顺序不同），unserialize() 可能静默失败或构造出不完整对象。JSON 方式虽绕过此问题，但若你仍用 unserialize() 处理缓存，则极易在此处翻车。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在 FrankenPHP 配置中关闭 preload：
opcache.preload=（空值）或注释掉该行 - 若必须开启 preload，请确保所有会被反序列化的类（如 DTO、ValueObject）在 preload 脚本中被显式 require，并且路径与运行时完全一致
- 用
opcache_get_status()['preload_statistics']确认实际预加载的文件列表，排查是否存在版本冲突
缓存键名含特殊字符，在 FrankenPHP + APCu 组合下被截断
APCu 对键名长度和字符集有限制（如不支持 UTF-8 多字节字符、最大键长 4096 字节），而 FrankenPHP 默认启用 APCu 作为系统级缓存池。若你用 md5(json_encode($params)) 生成键，但 $params 含中文或 emoji，APCu 可能静默截断键名，导致 get() 总是 miss，进而反复重建缓存——表面看是“数据错乱”，实则是根本没读到旧值。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 缓存键强制 ASCII 化：
bin2hex(sha256($string))替代md5()，避免非 ASCII 输入 - 在 FrankenPHP 的
php.ini中显式设置：apc.key_soft_limit=4096，并用apcu_cache_info('keys')抽样检查真实键长 - 对高风险键（如含用户输入的搜索条件）加长度断言：
if (strlen($key) > 3000) { throw new InvalidArgumentException('Cache key too long'); }
