Redis Functions不能复用旧Lua锁脚本，必须重写为带#!lua name=xxx头、显式注册函数的库；FUNCTION LOAD提供持久化、复制、跨节点可用保障，但语法更严格。
不能直接复用旧Lua锁脚本，必须重写为函数库并显式注册；FUNCTION LOAD 比 SCRIPT LOAD 多出持久化、复制、跨节点可用三大保障，但代价是语法更严格、初始化逻辑不能省。
FUNCTION LOAD 和 SCRIPT LOAD 在分布式锁场景下的实际差异
旧版 Lua 分布式锁依赖 SCRIPT LOAD + EVALSHA，但主从切换后从节点执行 EVALSHA 会报 ERR NOSCRIPT No matching script——因为脚本只存内存，不落盘也不复制。而 FUNCTION LOAD 把整个函数库写入 AOF/RDB，并通过主从同步推送到所有节点，FCALL 可直接在任意节点运行。
这意味着：锁逻辑部署一次，全集群生效；Redis 重启后函数仍在；无需客户端做“脚本预热”或重载判断。
-
SCRIPT LOAD是临时缓存，适合调试或单次原子操作，不适合生产级锁 -
FUNCTION LOAD是数据库对象，需带name=xxx声明库名，且同一库名重复注册必须加REPLACE - 锁的 key 初始化、过期设置、value 校验等逻辑，仍靠
redis.call()完成，但调用入口变成FCALL而非EVALSHA
重写分布式锁函数时必须处理的三个关键点
旧 Lua 锁脚本（如 setnx+expire 或 uuid+lua 删锁）不能直接粘贴进 Functions，因为 Functions 不接受裸脚本，且不自动包裹原子上下文——你得自己写清楚每一步是否容错、是否要判空、是否要防重入。
- 必须以
#!lua name=mylocklib开头，否则FUNCTION LOAD拒绝解析 - 获取锁时，不能再依赖
SET key value NX PX 10000一行搞定；要拆成redis.call('set', key, val, 'NX', 'PX', 10000)并检查返回值是否为"OK" - 释放锁必须显式校验 value 是否匹配：
if redis.call('get', key) == argv[1] then redis.call('del', key) end，漏掉这步就等于开放误删 - 函数必须通过
redis.register_function('acquire', handler)和redis.register_function('release', handler)显式注册，否则FCALL mylocklib.acquire找不到入口
FCALL 参数传入和原子性边界怎么把握
Functions 的原子性跟 Lua 一样，整个函数体执行期间 Redis 不调度其他命令。但参数传递方式变了：原来 Lua 脚本里 KEYS[1] 和 ARGV[1] 是隐式绑定的，现在你要在 FCALL 命令里明确列出 key 数量和参数顺序。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
例如锁 key 是 lock:order:123，客户端唯一标识是 node-abc-456，超时 30 秒：
FCALL mylocklib.acquire 1 lock:order:123 node-abc-456 30000
对应函数内要这样取：
local key = keys[1] local val = argv[1] local ttl = tonumber(argv[2])
- key 列表长度必须与
FCALL第二个参数一致，多一个少一个都会导致keys[i]访问越界 - 所有数字参数（如 TTL）必须用
tonumber()转换，Lua 默认当字符串处理，直接传给redis.call('set', ... 'PX', ttl)会失败 - 不支持默认参数或可选参数，缺一个
argv就得报错或 fallback，不能靠table.getn(argv) > 1灵活适配
别忽略函数库名冲突和版本回滚成本
函数库名在集群中全局唯一，FUNCTION LIST 输出里每个 library_name 对应一个独立命名空间。如果你上线了 mylocklib，又想灰度测试新版逻辑，不能改名再上——得用 FUNCTION REPLACE 覆盖，但老版本就没了。
虽然 Redis 支持 FUNCTION FLUSHDB mylocklib 1 回滚到某版本，但前提是：你记得版本号，且没执行过 FUNCTION FLUSHALL 清空全部函数。
- 生产环境建议用带环境前缀的库名，比如
mylocklib-prod-v1，避免测试库污染线上命名空间 - 每次
FUNCTION REPLACE都生成新版本，但 Redis 不自动清理旧版本，长期运行可能堆积大量废弃函数体 - 函数调试比 Lua 更麻烦：没有
redis.log()级别的实时输出，只能靠返回值或外部监控观察行为
