讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

如何在redis-py中安全传递参数并执行Redis Lua脚本?

梦丽大大_1766

梦丽大大_1766

发布时间:2026-11-10 06:17:34

|

752人浏览过

|

来源于php中文网

原创

直接拼接str()会导致Redis Lua脚本出错,因key含空格、换行或恶意代码会引发语法错误或命令注入;必须严格区分keys(键名,用于ACL和集群路由)与args(参数值),由redis-py自动序列化。

如何在redis-py中安全传递参数并执行redis lua脚本?

为什么直接用 str() 拼接 Lua 脚本会出问题

Redis Lua 脚本里不能依赖客户端对参数做字符串化,因为 redis-py 传入的 keys 和 args 是由 Redis 服务端原样接收的:服务端把 keys 当作键名数组、args 当作任意值数组,不经过任何 JSON 或 Python 字符串转义。如果你手动拼接 "SET " + key + " " + str(value),一旦 key 含空格、换行或非 ASCII 字符,Lua 就会报 ERR Error running script,甚至触发命令注入(比如 key = "foo; return redis.call('FLUSHDB')")。

redis-py 的 eval 和 evalsha 怎么传参才安全

必须严格区分 keys 和 args 两组参数,且只传原始 Python 对象(str、int、bytes、None),由 redis-py 自动序列化为 Redis 兼容格式:

  • keys 列表里的每个元素都会被 Redis 当作真实键名处理,用于 ACL 权限校验和集群路由;不能传空字符串或含 { 的键名(除非你明确知道分片规则)
  • args 列表里的值在 Lua 中通过 ARGV[i] 访问,自动转为 Redis 字符串(None → nil,True/False → "1"/"0"),但不会被当键名使用
  • 脚本里必须用 KEYS[1]、ARGV[1] 显式引用,不能硬编码键名或值

示例:

r = redis.Redis()
script = "return redis.call('GET', KEYS[1]) == ARGV[1]"
result = r.eval(script, keys=['mykey'], args=['expected_value'])

常见错误:混淆 keys 和 args 导致 ACL 拒绝或集群失败

Redis 6+ ACL 和 Redis Cluster 都依赖 keys 参数做权限与路由判断。如果该放 keys 的键名错塞进 args,会出现:

Sentinal Redis
Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务,分析慢查询并诊断问题。

下载
  • ACL 报错:NOPERM this script has keys that are not allowed
  • 集群模式下报错:CROSSSLOT Keys in request don't hash to the same slot(因为 args 不参与 slot 计算)
  • Lua 脚本里误用 ARGV[1] 当键名调用 redis.call('DEL', ARGV[1]),结果删错 key

原则:只要这个字符串要被 Redis 当作键名参与命令执行(GET、HGET、EXPIRE 等),就必须放进 keys;其他数据(如比较值、过期时间、JSON 字符串)一律走 args。

如何复用脚本并避免 SHA 冲突或加载失败

用 script_load + evalsha 能省网络开销,但要注意:

  • evalsha 失败时(NoScriptError)必须 fallback 到 eval,不能静默忽略
  • 不同 Redis 实例间 SHA 不共享,跨实例部署需确保脚本已预加载,或统一用 eval
  • 脚本内容有变(哪怕空格增减),SHA 就不同;建议用模块级常量存脚本字符串,避免拼接导致 SHA 波动

安全写法:

sha = r.script_load(script)
try:
    result = r.evalsha(sha, keys=['a'], args=['b'])
except redis.exceptions.NoScriptError:
    result = r.eval(script, keys=['a'], args=['b'])

最易被忽略的是:Lua 脚本里所有键名都必须显式出现在 keys 参数中 —— 即使是硬编码的键,只要它参与了 Redis 命令调用,就违反了原子性保证和集群约束。别图省事绕过 keys。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4889

2023.11.02

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4455

2023.11.14

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

8612

2024.04.02

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

663

2024.04.07

redis怎么解决数据一致性
redis怎么解决数据一致性

redis 提供了两种一致性模型,以维护副本数据一致性:强一致性 (sync) 确保写操作仅在复制到所有从节点后才完成;最终一致性 (async) 则在主节点上写操作后认为已完成,牺牲一致性换取性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

776

2024.04.07

mysql和redis怎么保证双写一致性
mysql和redis怎么保证双写一致性

确保 mysql 和 redis 双写一致性的技术包括:1、事务性更新:同时更新 mysql 和 redis,保证一致性;2、主从复制:mysql 主服务器更改同步到 redis 从服务器;3、基于事件的更新:mysql 记录更改并发送到 redis等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

8902

2024.04.07

redis缓存一般存些什么数据
redis缓存一般存些什么数据

redis缓存中存储的数据类型包括:字符串、哈希、列表、集合、有序集合、位图、地理空间数据和hyperloglog。这些数据类型适用于存储各种数据,从简单信息到复杂对象和地理位置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1200

2024.04.07

redis的8种数据类型有哪些
redis的8种数据类型有哪些

redis 提供 8 种数据类型:字符串(文本、数字、二进制)、哈希(键值对)、列表(有序集合)、集合(无序唯一元素)、有序集合(按分数排序)、地理空间(地理位置)、hyperloglog(估计大数据基数)和位图(位序列存储)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1396

2024.04.07

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

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

精品课程

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn