Node.js升级redis@3.x至4.x：hSet传数组报错咨询

核心结论 #

redis@4.x确实不再像v3.x那样支持直接给hSet传入单个数组作为参数，这一变更未出现在官方升级文档中，但从报错信息和源码逻辑可确认此变化。

问题根源 #

从报错栈指向的HSET.js代码来看，v4.x的hSet参数处理逻辑发生了变化：

• 它预期第一个参数是哈希键（字符串类型），第二个参数要么是键值对对象，要么后续跟多个交替的字段和值。
• 当你传入单个数组时，这个数组会被当作第一个参数（哈希键），而第二个参数默认是undefined。代码尝试对undefined调用Object.keys()，直接触发了TypeError: Cannot convert undefined or null to object。
• 而v3.x的参数解析逻辑允许直接接收包含哈希键、字段、值的数组，内部会自动展开数组并处理参数。

可行解决方案 #

你提到的两种写法都是有效的解决方式，另外还有一种适合多字段场景的写法：

• 直接传递分散参数：

client.hSet('hash key', 'hashtest 2', 'some other value').then(function (reply) {
  /* ... */
});

• 使用扩展运算符展开数组：

client.hSet(...['hash key', 'hashtest 2', 'some other value']).then(function (reply) {
  /* ... */
});

• 传入键值对对象（多字段时更简洁）：

client.hSet('hash key', { 'hashtest 2': 'some other value' }).then(function (reply) {
  /* ... */
});

参数类型补充 #

目前v4.x官方文档未明确枚举hSet支持的所有参数格式，但从源码和实践验证来看，它支持两种参数模式：

• 模式1：hSet(hashKey, field1, value1, field2, value2, ...)（逐个传递字段和值）
• 模式2：hSet(hashKey, { field1: value1, field2: value2, ... })（传递键值对对象）

内容的提问来源于stack exchange，提问作者Alana Storm