Redis Node.js 连接与哈希查询常见问题排查指南-php教程-PHP中文网

Redis Node.js 连接与哈希查询常见问题排查指南

本文详解 Redis 在 Node.js 中返回空对象 {} 的典型原因，重点对比 PHP 与 Node.js 客户端配置差异，涵盖端口不一致、数据库选择、键存在性验证及现代 Redis 客户端用法规范。

本文详解 redis 在 node.js 中返回空对象 {} 的典型原因，重点对比 php 与 node.js 客户端配置差异，涵盖端口不一致、数据库选择、键存在性验证及现代 redis 客户端用法规范。

在 Node.js 中使用 Redis 时遇到 hGetAll() 返回 [Object: null prototype] {}（即空对象），而相同逻辑在 PHP 中正常工作，这通常并非代码语法错误，而是环境配置或数据状态不一致所致。核心问题往往隐藏在三个关键环节：连接端口、目标数据库、键的实际存在性。

? 一、首要排查：端口不一致（最常见陷阱）

您提供的 PHP 代码连接的是 6378 端口：

$redis->connect("192.16.200.38", 6378); // ← 注意：6378

而 Node.js 代码却连接了 6379：

const client = redis.createClient({
  host: "192.16.200.38",
  port: 6379 // ← 错误！应与 PHP 一致为 6378
});

✅ 修正方案：统一端口。若服务实际运行在 6378，Node.js 必须显式指定：

const client = redis.createClient({
  socket: {
    host: "192.16.200.38",
    port: 6378 // ✅ 修正为 6378
  }
});

⚠️ 注意：redis@4.x+ 已弃用 host/port 顶层选项，推荐使用 socket 配置对象（如上所示）。

Aria2 Json Rpc
通过 JSON‑RPC 2.0 与 aria2 下载管理器交互，使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载

? 二、确认数据库（DB）与键是否存在

即使端口正确，hGetAll() 返回空对象也明确表示：该 key 在所选数据库中不存在，或不是哈希类型。

PHP 中执行了 $redis->select(2) → 切换到 DB 2；
Node.js 中 await client.select(2) 同样切换 DB 2 —— 此步无误；
但需验证：key + 'myCode' 这个完整键名是否真实存在于 DB 2 中？

推荐通过 Redis CLI 快速验证：

# 连接到正确的端口和 DB
redis-cli -h 192.16.200.38 -p 6378 -n 2

# 检查键是否存在且为哈希类型
EXISTS "yourKeymyCode"     # 应返回 1
TYPE "yourKeymyCode"       # 应返回 "hash"
HLEN "yourKeymyCode"       # 查看字段数量（非零才合理）
HGETALL "yourKeymyCode"    # 直接查看全部内容

✅ 三、完整可运行的 Node.js 示例（v4.6+）

import { createClient } from 'redis';

const key = 'yourActualKey'; // 替换为真实前缀

const client = createClient({
  socket: {
    host: '192.16.200.38',
    port: 6378 // ✅ 关键：与 PHP 一致
  }
});

client.on('error', (err) => console.error('Redis Client Error:', err));
client.on('connect', () => console.log('✅ Connected to Redis'));

await client.connect();
await client.select(2); // 切换至 DB 2

const fullKey = key + 'myCode';
const result = await client.hGetAll(fullKey);

// 健壮性检查
if (Object.keys(result).length === 0) {
  console.warn(`⚠️  Warning: Key '${fullKey}' is empty or does not exist in DB 2.`);
  console.log('? Verify via CLI: redis-cli -h 192.16.200.38 -p 6378 -n 2 HGETALL "' + fullKey + '"');
} else {
  console.log('✅ Success:', result);
}

await client.quit();