Spring Data Redis需用RedisScript<List<T>>声明脚本类型并指定泛型，才能正确映射Lua返回的数组；仅设ReturnType.MULTI不足，因它不负责Java类型转换。
Redis Lua脚本返回数组时，默认被当成nil或单个值？
Redis 执行 Lua 脚本（eval / evalsha）时，Lua 中的 return {1,2,3} 会被自动转换成 Redis 协议中的 array reply，但 Java 客户端（如 Lettuce、Jedis）或 Python（redis-py）默认不会把它映射成 List 对象——尤其是你用的是 Spring Data Redis 的 execute() 方法，它默认返回 Object，且不带类型信息。
根本原因不是 Lua 写错了，而是客户端没告诉 Redis「我要 List」，也没在代码里声明怎么解析这个 array reply。
Spring Data Redis 怎么设 ReturnType 并正确映射 List？
Spring Data Redis 的 RedisTemplate.execute() 重载方法中，必须显式传入 ReturnType 枚举 + 结果转换逻辑。只设 ReturnType.MULTI 不够，它只影响底层协议解析行为（比如是否把 array 当成批量响应），不负责 Java 类型映射。
-
ReturnType.MULTI：表示期望返回 Redis array reply（对应 Lua 的 table），但返回值仍是Object，通常是List<Object>或null - 真正要得到
List<String>或List<Long>，得配合RedisCallback或用execute(RedisScript<T>, ...)形式，并指定泛型T - 推荐用
RedisScript<List<String>>声明脚本类型，再调用redisTemplate.execute(script, keys, args...)，Spring 会自动尝试 cast 和转换
示例：
RedisScript<List<String>> script = RedisScript.of(
"return {KEYS[1], ARGV[1]}",
String.class
);
List<String> result = redisTemplate.execute(script,
Collections.singletonList("key1"), "val1");
// result = ["key1", "val1"]
Jedis 和 redis-py 怎么处理 Lua 返回的 List？
Jedis 的 eval() 默认把 Redis array reply 映射为 List<Object>，不需要额外设 ReturnType；redis-py 的 eval() 同理，直接返回 Python list。但注意类型擦除问题：
- Jedis 返回的
List<Object>里可能是byte[]（二进制响应）或String，取决于 Redis 返回的是 bulk string 还是 integer —— Lua 中return {1,"a",nil}会变成[1L, "a", null]，但nil在 Redis 协议里是 缺失项，实际收到的是[1L, "a"] - redis-py 把 Redis integer 自动转成 Python
int，bulk string 转成str，但nil会变成None，且 Lua table 空位不保留（{1,nil,3}→[1,3]） - 如果 Lua 返回的是嵌套结构（如
{{1,2},{3}}），所有客户端都只做一层展开，不会自动转成二维 list —— 你得自己遍历 parse
为什么 Lua 脚本里用 table.pack() 或 redis.call("hgetall",...) 返回的 List 映射失败？
常见错觉：以为 redis.call("hgetall", "myhash") 返回的是 key-value 对列表（没错），但它的格式是 ["k1","v1","k2","v2"]，不是 [["k1","v1"],["k2","v2"]]。如果你在 Java 里期待一个 List<Map.Entry>，那注定失败——Redis 没有「嵌套数组」概念，Lua table 一维展开后就是扁平 list。
更隐蔽的坑：
- Lua 中
table.insert(t, nil)无效，nil不会进入结果；{1, nil, 3}和{1, 3}在 Redis 返回完全一样 - 使用
redis.status_reply或redis.error_reply会中断整个返回流程，导致 array reply 被吞掉，客户端只收到 error 字符串 - Spring Data Redis 的
DefaultRedisScript如果泛型写成RedisScript<List>（没带类型参数），运行时类型擦除会导致反序列化失败，报ClassCastException
最易被忽略的一点：Lua 脚本的返回值必须是「可序列化为 Redis 协议基本类型的 Lua 值」——即 string、number、boolean、table（且 table 必须是纯数组形式，不能含 string key），否则 Redis 直接报错 ERR Error running script (call to f_...): @user_script:?: user_script:?: bad argument #1 to 'write' (string expected, got boolean)。
