如何在Redis Lua脚本中处理JSON字符串的编解码?

千萱大大_9641

千萱大大_9641

2026-11-03

837人浏览

原创

Redis 6.2+ 不支持内置cjson,require "cjson"必报错;需手动嵌入精简版cjson.lua实现decode/encode,注意空值处理、性能限制及错误检查。

如何在redis lua脚本中处理json字符串的编解码?

Redis 6.2+ 内置 cjson 不可用,别白费劲试了

Redis 自身不提供 JSON 编解码函数,即使你用的是 7.0,cjson 也**不会自动加载到 Lua 环境里**。官方 Lua 沙箱明确禁用 require,所以 require "cjson" 会直接报错 error: user_script:1: module 'cjson' not found。别在脚本里写这行,也别指望 Redis 运行时帮你挂载。

必须把 JSON 编解码逻辑“硬编码”进 Lua 脚本

最稳妥的做法是把精简版 cjson 的核心函数(如 encode/decode)以纯 Lua 实现嵌入脚本开头。推荐使用已验证的轻量实现,比如 Redis 官方测试套件中自带的 cjson.lua(注意:它不是运行时模块,而是可复制粘贴的字符串解析器)。

  • 只保留 cjson.decode 和 cjson.encode,删掉所有非必要功能(如流式解析、循环引用检测)
  • 确保不使用 loadstring 或 assert —— Redis Lua 沙箱禁用这些
  • 嵌入后,调用形如 cjson.decode(ARGV[1]),而非 json.decode(后者不存在)
  • 注意空值处理:cjson.decode("null") 返回 nil,而 Redis 命令不能传 nil 给 redis.call,需提前判空

用 redis.call("JSON.SET")?那是 RedisJSON 模块,和 Lua 脚本无关

如果你启用了 RedisJSON 模块,JSON.SET/JSON.GET 是独立命令,可在 Lua 脚本里通过 redis.call 调用,但它**不解决 Lua 内部的 JSON 处理需求**。比如你想在脚本里解析客户端传来的 JSON 字符串做条件判断,还是得靠嵌入的 Lua 解析器。

jm-jsjkxyjs02-zlm-405
jm-jsjkxyjs02-zlm-405

使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。

下载
  • redis.call("JSON.SET", "mykey", "$", ARGV[1]) 可存,但无法对 ARGV[1] 做字段提取或修改后再存
  • 想取 ARGV[1] 里的 user.id 并拼进 key 名?必须先 cjson.decode,再取 obj.user.id
  • RedisJSON 返回的是字符串,不是 Lua 表,redis.call("JSON.GET", "mykey", "$.name") 返回 "\"Alice\"",还得再 decode 一次才能当字符串用

性能与长度限制:别在 Lua 里解析大 JSON

Redis Lua 脚本有严格的执行时间限制(默认 lua-time-limit = 5000ms)和内存约束。一个 10KB 的 JSON 字符串经 Lua 解析后可能膨胀为数倍内存占用,极易触发 BUSY 错误或被强制中断。

  • 单次 cjson.decode 建议控制在 1KB 以内,嵌套层级不超过 5 层
  • 避免在循环里反复 decode/encode —— 提前解一次,复用结果表
  • 如果 ARGV 中 JSON 字段只是用来取一两个字段,考虑让客户端拆解后传原子值(如 ARGV[1] = user_id, ARGV[2] = user_name),绕过解析开销
  • 出错时 cjson.decode 返回 nil, error_msg,务必检查第二返回值,否则后续访问 nil.field 报 attempt to index a nil value

真正麻烦的不是语法,是得自己维护那几百行嵌入的 JSON 解析器代码,并且每次升级 Redis 都得重新核对兼容性 —— 这就是纯 Lua 方案的代价。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1838

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2964

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6244

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

6169

6

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

2024.03.22

7754

16

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2024.04.29

11734

11

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.07.29

6059

17

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.07

6727

13

常用字符串方法大全
常用字符串方法大全

常用字符串方法大全

2025.08.08

3328

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习