Redis Lua脚本中如何实现数据压缩与解压？-Redis-PHP中文网

redis lua脚本无法直接压缩/解压数据，因内置lua禁用第三方库加载和系统调用；compress/decompress命令不可在lua中调用；推荐客户端预压缩后透传，由客户端解压。

redis lua脚本中如何实现数据压缩与解压？

Redis 本身不提供原生的 LZ4、Zstd 或 zlib 压缩函数，Lua 脚本里也**没有内置压缩能力**。想在 Lua 中压缩/解压数据，必须依赖外部模块或绕过 Lua 直接由客户端处理。

Redis Lua 脚本里不能直接调用 zlib / LZ4

Redis 内置的 Lua 解释器（Lua 5.1）默认只加载 math、string、table、redis 等有限库，zlib、lz4 等第三方压缩库**不会自动可用**，也无法通过 require 动态加载（Redis 禁用了 package.loadlib 和文件 I/O）。

常见错误现象：

执行 local z = require("zlib") → 报错 module 'zlib' not found
尝试用 os.execute 或 io.open → 报错 attempt to call a nil value（被禁用）

COMPRESS / DECOMPRESS 命令不是通用 Lua 接口

Redis 7.0+ 确实新增了 COMPRESS 和 DECOMPRESS 命令，但它们：

只能在 Redis CLI 或客户端命令中直接调用，比如 COMPRESS "hello"
不能在 Lua 脚本中通过 redis.call("COMPRESS", ...) 使用 —— 这些命令未注册为可从 Lua 调用的 Redis 命令
底层用的是 LZ4，但仅限于交互式或 pipeline 场景，不开放给脚本引擎

验证方式：在 Lua 脚本里写 redis.call("COMPRESS", "test")，会报错 ERR unknown command 'COMPRESS'（即使 Redis 版本支持该命令）。

Redis 8.2.3

Redis 8.2.3 是一款安全优先的高性能键值存储系统。该版本紧急修复了可能引发远程代码执行（RCE）的高危漏洞（CVE-2025-62507），并解决了 HyperLogLog 及 Cuckoo Filter 等数据结构在特定场景下的崩溃问题。建议所有用户立即升级，以保障生产环境的系统稳定与数据安全。

下载

可行方案：客户端预压缩 + Lua 透传

真正能落地的做法是把压缩/解压逻辑完全移出 Lua，只让 Lua 处理“已压缩的字节流”：

客户端（Python/Java/Go）用 lz4.frame.compress() 或 zlib.compress() 处理原始数据
把压缩后的 bytes 直接 SET 到 Redis，key 可加后缀如 user:123:z 标识已压缩
Lua 脚本里只做业务逻辑，比如：redis.call("GET", KEYS[1]) 拿到压缩 blob，再 redis.call("INCR", "hit_count")，不做解压
解压动作一定留在客户端 —— Lua 拿到 GET 返回值后，由调用方用对应算法解压

示例（Python 客户端）：

import redis, lz4.frame
r = redis.Redis()
data = b'{"id":1,"name":"alice"}'
compressed = lz4.frame.compress(data)
r.set('user:123:z', compressed)  # 存压缩体
# Lua 脚本只读：redis.eval("return redis.call('GET', KEYS[1])", 1, 'user:123:z')
# 客户端拿到返回值后再解压：lz4.frame.decompress(compressed)