Node.js中Redis命令（hSet/hGetAll）挂起未解决问题排查

你的Redis客户端始终未进入就绪状态（isReady为false）是命令挂起的根本原因，以下是具体问题分析和修复方案：

核心问题分析 #

1. connect事件不等于就绪状态：你监听的connect事件仅表示客户端与Redis的Socket连接已建立，但客户端尚未完成初始化流程（如数据库选择、身份验证等），此时无法处理命令。
2. 服务启动时机过早：你未等待client.connect()完成就启动了Express服务器，导致请求进来时Redis客户端还未准备好接收命令。

解决方案 #

1. 修正Redis连接逻辑，确保就绪后启动服务 #

修改连接代码，等待client.connect()的Promise解析后再启动服务，同时监听ready事件确认客户端就绪：

const { createClient } = require('redis');
const express = require('express');
const app = express();

const client = createClient();

// 监听客户端错误
client.on('error', err => console.log('Client Error', err));

// 监听就绪事件（替代connect事件）
client.on('ready', () => {
    console.log('Redis Client Ready');
    console.log('isOpen: ' + client.isOpen);
    console.log('isReady: ' + client.isReady);
});

// 异步启动服务，确保Redis连接就绪
async function startServer() {
    try {
        await client.connect();
        app.listen(3000, () => {
            console.log('Server started on port 3000');
        });
    } catch (err) {
        console.error('Failed to connect to Redis:', err);
        process.exit(1);
    }
}

startServer();

2. 使用Promise/async-await替代回调调用Redis命令 #

Node-Redis v4采用Promise优先设计，建议使用async-await语法避免回调相关问题：

app.post('/user/search', async (req, res) => {
    const id = req.body.id;
    
    try {
        const user = await client.hGetAll(id);
        
        // Redis中不存在目标键时，hGetAll返回空对象
        if (Object.keys(user).length === 0) {
            return res.render('someview', { error: 'user does not exist' });
        }
        
        res.render('someview2', { user });
    } catch (err) {
        console.error('Fetch user error:', err);
        res.render('someview', { error: 'Failed to retrieve user' });
    }
});

额外检查点 #

• 若Redis服务器使用非默认配置（如自定义端口、需要认证），需在createClient时传入对应参数：createClient({ url: 'redis://username:password@host:port' })
• 确认你的Node-Redis版本为v4+，旧版本API与当前代码不兼容

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