Laravel缓存序列化优化技巧

如果你正在为 Laravel 应用中缓存体积过大、Redis 内存占用高或响应变慢而困扰，这篇文章直击痛点——通过四步精准优化缓存序列化：从配置排除权限模型冗余字段、自定义 Eloquent 模型的序列化白名单、启用更紧凑的 msgpack 序列化协议，到在资源库层手动精简数据再缓存，层层递进地将缓存体积减少 30%–40%，显著提升性能与资源利用率，尤其适合高频缓存权限、用户、文章等结构化数据的中大型项目。

如果您在 Laravel 应用中使用缓存存储权限、模型或集合数据，但发现缓存体积过大导致内存占用高或 Redis 响应延迟，则可能是由于默认序列化方式保留了冗余字段。以下是优化缓存序列化体积的具体方法：

一、移除权限模型中的非必要字段

Laravel Permission 在缓存权限数据前，会调用 getSerializedPermissionsForCache() 方法预处理数据，通过配置项 permission.cache.column_names_except 指定需排除的数据库字段，从而减小序列化后体积。

1、打开 config/permission.php 文件（若不存在则运行 php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" 生成）。

2、在该配置文件中定位到 cache 数组段，添加或修改 column_names_except 键：

'column_names_except' => ['created_at', 'updated_at', 'deleted_at']

3、确保所有权限模型（如 Permission、Role）在被缓存前均经过此过滤逻辑，该设置将使缓存体积减少约 30–40%。

二、为 Eloquent 模型自定义序列化白名单

当缓存 Eloquent 模型实例时，Laravel 默认序列化全部属性与关系，包含隐藏字段、访问器及大量元数据。通过重写模型的 $casts、$appends 和 $hidden 属性，可精确控制序列化内容范围。

1、在目标模型类（如 App\Models\User）中声明需保留的字段：

protected $fillable = ['id', 'name', 'email'];

2、显式屏蔽不参与缓存的字段：

protected $hidden = ['password', 'remember_token', 'two_factor_secret'];

3、禁用自动追加的访问器（避免序列化计算结果）：

protected $appends = [];

4、若需进一步压缩，可覆盖 __serialize() 方法，仅返回关键数组：

public function __serialize(): array { return ['id' => $this->id, 'name' => $this->name, 'email' => $this->email]; }

三、使用 msgpack 替代 PHP 原生序列化

Laravel 13 引入类型感知序列化机制，默认对数组和简单对象启用更紧凑的 msgpack 编码格式，相比 serialize() 可减少约 40% 内存占用。该机制无需额外扩展，但需确认缓存驱动支持二进制值存储。

1、确认当前缓存驱动为 redis 或 memcached（二者均支持二进制值）。

2、在 config/cache.php 的对应 store 配置中启用 msgpack：

'options' => ['serializer' => \Illuminate\Cache\RedisStore::SERIALIZER_MSGPACK],

3、验证 Redis 中缓存值是否以二进制形式存储（使用 redis-cli 执行 GET your_key，响应应为不可读字节流而非 PHP 字符串）。

4、确保项目已安装 ext-msgpack PHP 扩展；若未安装，可用纯 PHP 实现回退，但性能略低。

四、在资源库层手动序列化精简数据

当使用资源库模式（Repository Pattern）封装缓存逻辑时，可在写入缓存前主动剥离模型结构，仅保留业务必需字段，绕过框架自动序列化流程。

1、在资源库类（如 App\Repos\PostRepo）中编写缓存方法：

public function cachePostSummary(int $id): void { $post = $this->post->select('id', 'title', 'slug', 'published_at')->find($id); if ($post) { Cache::put("post_summary_{$id}", $post->only(['id', 'title', 'slug']), 3600); } }

2、调用该方法替代直接缓存完整模型实例：

$repo = app(PostRepo::class); $repo->cachePostSummary(123);

3、读取时直接获取精简数组，避免反序列化开销与内存膨胀。

本篇关于《Laravel缓存序列化优化技巧》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！