Lettuce 的动态命令接口（@Command）对 Redis 原生命令参数数量有严格校验；HMSET 在 Redis 7.0+ 已被标记为弃用，实际应使用 HSET，但若需兼容旧版或特定场景，必须按 Redis 协议要求传入 ≥4 个参数（key + 至少一对 field/value），不可直接传 Map。
letture 的动态命令接口（@command）对 redis 原生命令参数数量有严格校验；hmset 在 redis 7.0+ 已被标记为弃用，实际应使用 hset，但若需兼容旧版或特定场景，必须按 redis 协议要求传入 ≥4 个参数（key + 至少一对 field/value），不可直接传 map。
在 Lettuce 的动态命令接口（Commands + @Command）中，直接为 HMSET 声明接收 Map
Redis 官方文档明确指出：HMSET key field value [field value ...] 至少需要 3 个参数（key、field、value），但 Lettuce 实际校验逻辑基于 COMMAND 响应中的 arity 字段。执行 COMMAND INFO HMSET 可得：
1) "hmset" 2) (integer) -4 # ← arity = -4 表示：至少 4 个参数（key + field + value + ...） 3) 1) "write" 2) "denyoom" 4) (integer) 1 5) (integer) 1 6) (integer) 1
其中 arity = -4 表示：最少需传入 4 个参数（即 key, field1, value1, field2 等，成对追加）。因此，以下声明是非法的：
@Command("HMSET")
Void hmset(String key, Map<String, String> map); // ❌ 错误：仅声明 2 个参数，不满足 arity ≥4✅ 正确实现方式（推荐）
方案一：使用标准 HSET（强烈推荐）
HSET 是 HMSET 的替代命令（自 Redis 4.0 起支持多 field/value），语义一致且 arity 为 -3（key + field/value 对），更简洁安全：
@Command("HSET")
Long hset(String key, String field, String value, String... fieldValues);
// 调用示例：
commands.hset("user:1001", "name", "Alice", "age", "30", "city", "Beijing");✅ 返回值为插入/更新的字段数（Long），符合 Lettuce 批处理要求（支持 void 或 Future>，Long 自动包装为 Future
）。
方案二：严格适配 HMSET（仅限必须兼容旧版场景）
若因历史原因必须调用 HMSET，需手动展开 Map 为可变参数：
@Command("HMSET")
String hmset(String key, String field, String value, String... fieldValues);
// 注意：返回类型必须为 void 或 Future<?>；String 不可用于批处理方法（见报错提示）
// → 因此实际应声明为 void，并确保未启用 BatchExecutor（或改用非批处理接口）但需注意：BatchExecutor 要求批处理方法返回 void 或 Future>，故 String 返回类型会触发如下错误：
Batching command method [...] must declare either a Future or void return type
因此，若需在批处理上下文中使用，应改为：
@Command("HMSET")
void hmset(String key, String field, String value, String... fieldValues);并确保调用前已展开 Map：
Map<String, String> data = Map.of("name", "Bob", "role", "admin");
// 手动转为参数数组（工具方法示例）：
Object[] args = Stream.concat(
Stream.of("user:1002"),
data.entrySet().stream()
.flatMap(e -> Stream.of(e.getKey(), e.getValue()))
).toArray();
// 若使用反射调用或自定义封装，可避免硬编码
commands.hmset("user:1002", "name", "Bob", "role", "admin"); // ✅ 合法调用⚠️ 重要注意事项
- HMSET 已弃用：Redis 4.0+ 推荐统一使用 HSET（支持单/多 field，性能更优，API 更一致）；
- 不要混用返回类型：批处理接口（BatchExecutor）中，所有方法必须返回 void 或 Future>；
- 动态校验不可绕过：Lettuce 的 DefaultCommandMethodVerifier 依赖 Redis 服务端元数据，无法通过注解关闭；
- 类型安全建议：如需 Map 批量操作，可封装工具类，内部调用 HSET 并自动展开，保持接口简洁：
default void hsetAll(String key, Map<String, String> entries) {
if (entries.isEmpty()) return;
var iter = entries.entrySet().iterator();
var first = iter.next();
String[] args = new String[2 * entries.size() + 1];
args[0] = key;
args[1] = first.getKey();
args[2] = first.getValue();
int i = 3;
while (iter.hasNext()) {
var e = iter.next();
args[i++] = e.getKey();
args[i++] = e.getValue();
}
// 使用反射或 CommandWrapper 调用 hset(...) 方法
}综上，优先采用 HSET 替代 HMSET，并以可变参数形式声明方法，既满足 Lettuce 的元数据校验，又保持代码清晰与兼容性。
