Next.js 13路由处理器中Redis单例失效，连接数超限问题排查

问题根源 #

1. Serverless环境的冷启动与隔离性
   Vercel等Serverless平台会为并发请求启动独立的函数进程，每个进程都会重新加载代码模块。如果客户端实例不是在模块级别预创建并缓存，每次冷启动都会新建连接。即使是模块级导出，不同进程会有各自的实例，但至少能保证同一个进程内的请求复用连接，大幅降低并发连接数。

2. 错误的客户端初始化时机
   如果你的工具类在每次调用方法时才创建Redis客户端，或者在路由处理函数内部动态创建客户端，必然会导致每个请求都新建连接。

3. 无效的单例实现
   若单例模式是在工具类内部动态生成实例（比如每次调用getInstance才初始化，但没有在模块级别提前导出），在Serverless的模块重新加载机制下，还是会重复创建实例。

解决办法 #

方法1：模块级别直接导出Redis客户端 #

利用Node.js的模块缓存机制，在单独模块中创建客户端并导出，确保同一进程内所有请求复用同一个实例：

// lib/redis.js
import { Redis } from '@upstash/redis';

// 模块级别初始化，Node.js会缓存该实例
export const redis = new Redis({
  url: process.env.UPSTASH_REDIS_URL,
  token: process.env.UPSTASH_REDIS_TOKEN,
});

在路由处理器中直接导入使用：

// app/api/xxx/route.js
import { redis } from '@/lib/redis';

export async function GET() {
  const data = await redis.get('key');
  return Response.json({ data });
}

方法2：工具类实现模块级单例 #

如果必须封装工具类，确保客户端实例在模块级别被初始化并缓存，避免每次调用方法时重建：

// lib/redis-utils.js
import { Redis } from '@upstash/redis';

class RedisUtils {
  #client;

  constructor() {
    this.#client = new Redis({
      url: process.env.UPSTASH_REDIS_URL,
      token: process.env.UPSTASH_REDIS_TOKEN,
    });
  }

  async get(key) {
    return this.#client.get(key);
  }

  async set(key, value) {
    return this.#client.set(key, value);
  }
}

// 模块级别创建并导出单例，确保同一进程内复用
export const redisUtils = new RedisUtils();

在路由中导入redisUtils直接调用方法即可，无需每次实例化。

方法3：排查重复初始化逻辑 #

检查代码中是否存在以下情况：

• 在路由处理函数内部创建Redis客户端实例
• 工具类的方法内部重新初始化客户端
• 多次导入不同路径的Redis模块（比如相对路径错误导致加载多个模块副本）

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