Node.js集成Redis遇报错：net.connect/net.is-ip不是函数求助

问题描述 #

尝试在Node.js中集成Redis，但运行代码时出现以下问题：

• 使用redis@4.6.12版本时，报错：TypeError: net.connect is not a function
• 更换为redis@3.1.2版本后，报错：net.is-ip is not a Function

客户端代码 #

import { createClient } from 'redis'

export const client = createClient({
    socket: {
    host: "localhost",
    port: 6379
   },
  });

await client.connect();
console.log("client.isOpen: " + client.isOpen)

v4.6.12版本报错信息 #

socket.js:199 Uncaught (in promise) TypeError: net.connect is not a function
at RedisSocket._RedisSocket_createNetSocket (socket.js:199:17)
at eval (socket.js:175:346)
at new Promise (<anonymous>)
at RedisSocket._RedisSocket_createSocket (socket.js:171:10)
at RedisSocket._RedisSocket_connect (socket.js:148:148)
at RedisSocket.connect (socket.js:55:92)
at Commander.connect (index.js:196:66)
at eval (index.js:10:1)
at __webpack_require__.a (app.js:814:13)
at eval (index.js:1:21)

package.json依赖 #

"dependencies": {
  "-": "^0.0.1",
  "axios": "^1.6.3",
  "connect-redis": "^7.1.0",
  "core-js": "^3.8.3",
  "crypto-browserify": "^3.12.0",
  "dayjs": "^1.11.10",
  "for": "^0.0.1-dev.0",
  "install": "^0.13.0",
  "net": "^1.0.2",
  "node-polyfill-webpack-plugin": "^3.0.0",
  "node-redis": "^0.1.7",
  "redis": "^4.6.12",
  "stream-browserify": "^3.0.0",
  "tls": "^0.0.1",
  "url": "^0.11.3",
  "util": "^0.12.5",
  "vue": "^3.2.13",
  "vue-router": "^4.2.5"
 },

问题根源 #

你是在浏览器环境中执行Redis客户端代码了。redis库是专为Node.js环境设计的，依赖Node.js原生的net模块（用于TCP连接），但浏览器出于安全限制不支持直接发起TCP连接，也没有内置net模块，所以会抛出这些错误。你安装的net、tls等polyfill包无法解决这个本质问题。

解决方案 #

1. 将Redis操作移至Node.js后端 #

不要在Vue前端代码中直接调用Redis客户端，应该搭建一个Node.js后端服务（比如用Express、Koa），在后端处理Redis的读写逻辑，前端通过HTTP接口与后端交互。

2. 清理无用依赖 #

删除package.json中以下无意义或重复的依赖包：

• "-"、"for"：无效的包名
• "install"：这是一个CLI工具，不需要作为项目依赖
• "net"、"tls"：浏览器无法模拟这些Node.js核心模块
• "node-redis"：这是redis库的旧版别名，你已经安装了官方的redis@4.x

3. 后端正确配置Redis客户端（Node.js环境） #

在Node.js后端中使用redis@4.x的示例代码：

import { createClient } from 'redis';

async function initRedis() {
  const client = createClient({
    socket: {
      host: "localhost",
      port: 6379
    },
  });

  // 监听错误事件
  client.on('error', err => console.error('Redis客户端错误:', err));
  
  await client.connect();
  console.log("Redis连接状态:", client.isOpen);
  return client;
}

// 初始化连接
const redisClient = await initRedis();

4. 前端通过接口调用后端Redis操作 #

示例后端接口（Express框架）：

import express from 'express';
import cors from 'cors';
import { createClient } from 'redis';

const app = express();
app.use(cors()); // 允许前端跨域请求

// 初始化Redis客户端
const redisClient = await createClient({ socket: { host: 'localhost', port: 6379 } }).connect();

// 测试接口：设置并获取Redis中的值
app.get('/api/redis-test', async (req, res) => {
  try {
    await redisClient.set('test-key', 'Hello Redis!');
    const value = await redisClient.get('test-key');
    res.json({ success: true, value });
  } catch (err) {
    res.status(500).json({ success: false, error: err.message });
  }
});

app.listen(3000, () => {
  console.log('后端服务运行在http://localhost:3000');
});

前端Vue代码调用接口：

import axios from 'axios';

async function testRedis() {
  try {
    const response = await axios.get('http://localhost:3000/api/redis-test');
    console.log('Redis返回值:', response.data.value);
  } catch (err) {
    console.error('请求失败:', err);
  }
}

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