Node.js中Redis单例连接问题：如何全局复用Redis客户端？

我懂你现在遇到的困扰——在多个文件里重复创建Redis客户端会导致多次建立连接，而直接从app.js导出客户端又碰到了Cannot read property 'hgetall' of undefined的错误，这大概率是循环依赖或者导出时机不对导致的：当routes.js导入app.js时，app.js里的client可能还没完成初始化，所以拿到的是undefined。

下面是最稳妥的解决方案，通过单独抽离Redis客户端模块来实现全局复用：

步骤1：创建独立的Redis客户端模块 #

新建一个专门的文件（比如utils/redis-client.js），在这里完成Redis客户端的初始化和导出，这样所有需要用Redis的地方都从这里导入，保证只创建一次连接：

const redis = require('redis');

// 创建客户端（如果有密码、端口等配置，可在这里添加，比如 redis.createClient({ password: 'your-password', port: 6379 })）
const client = redis.createClient();

// 监听连接状态
client.on('error', function (err) {
  console.log('Redis连接出错: ', err);
});

client.on('connect', function () {
  console.log('成功连接到Redis');
});

// 导出客户端
module.exports = client;

步骤2：在app.js中导入并使用这个客户端 #

现在app.js里不需要再创建客户端，直接导入刚才的模块即可：

const express = require('express');
const redisClient = require('./utils/redis-client'); // 导入Redis客户端
const app = express();

// 这里可以用redisClient处理会话逻辑，比如配合express-session：
// const session = require('express-session');
// const RedisStore = require('connect-redis')(session);
// app.use(session({
//   store: new RedisStore({ client: redisClient }),
//   secret: 'your-session-secret',
//   resave: false,
//   saveUninitialized: false
// }));

// 其他app.js业务逻辑...

步骤3：在routes.js中导入并使用同一个客户端 #

同样，routes.js里直接导入这个独立的客户端模块，不用再创建新的：

const express = require('express');
const router = express.Router();
const redisClient = require('../utils/redis-client'); // 导入同一个客户端

router.get('/get-data', async (req, res) => {
  try {
    // 使用客户端操作Redis，比如hgetall
    const data = await redisClient.hgetall('target-key');
    res.json(data);
  } catch (err) {
    res.status(500).send('Redis操作出错: ' + err);
  }
});

module.exports = router;

为什么之前的方法会出错？ #

当你在app.js里导出client，然后routes.js导入require("../app.js").client时，很可能出现了循环依赖：app.js通常会导入routes.js来挂载路由，而routes.js又反过来导入app.js的client，这时候Node.js模块加载时，app.js还没完成client的初始化，所以导出的client是undefined，调用hgetall自然会报错。

通过抽离独立的Redis客户端模块，就能完全避免这个问题，同时保证整个项目只用一个Redis连接，既高效又避免了重复连接的冗余问题。

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