Redis 在 NestJS 中：你不知道自己需要的 RedisX 解决方案

Source: Dev.to

介绍

厌倦了在 NestJS 应用中为 Redis 操作使用多个库吗？来认识 NestJS RedisX —— 一个集缓存、锁、限流等功能于一体的全能工具箱，所有功能都基于单一的 Redis 连接运行。这降低了复杂度并实现了配置的集中管理。

特性

RedisX 基于模块化插件系统构建。只安装你需要的部分：

• @nestjs-redisx/cache – 带防击穿的 L1/L2 缓存。
• @nestjs-redisx/locks – 支持自动续期的分布式锁。
• @nestjs-redisx/rate-limit – 多种限流策略。
• @nestjs-redisx/idempotency – 确保请求幂等性。
• @nestjs-redisx/streams – 支持事件驱动架构。
• @nestjs-redisx/metrics – 与 Prometheus 指标集成。
• @nestjs-redisx/tracing – 支持 OpenTelemetry 跟踪。

安装

npm install @nestjs-redisx/core @nestjs-redisx/cache @nestjs-redisx/locks

在同一条命令中添加你需要的其他插件。

配置示例

import { Module } from '@nestjs/common';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { RedisModule } from '@nestjs-redisx/core';
import { CachePlugin } from '@nestjs-redisx/cache';
import { LocksPlugin } from '@nestjs-redisx/locks';

@Module({
  imports: [
    ConfigModule.forRoot({ isGlobal: true }),
    RedisModule.forRootAsync({
      imports: [ConfigModule],
      inject: [ConfigService],
      plugins: [
        CachePlugin.registerAsync({
          imports: [ConfigModule],
          inject: [ConfigService],
          useFactory: (config: ConfigService) => ({
            l1: { enabled: true, maxSize: 1000, ttl: 60 },
            defaultTtl: config.get('CACHE_TTL', 300),
          }),
        }),
        new LocksPlugin({ retryAttempts: 3, retryDelay: 200 }),
      ],
      useFactory: (config: ConfigService) => ({
        clients: {
          type: 'single',
          host: config.get('REDIS_HOST', 'localhost'),
          port: config.get('REDIS_PORT', 6379),
        },
      }),
    }),
  ],
})
export class AppModule {}

结论

RedisX 为 NestJS 应用提供了简洁统一的 Redis 集成方式。再也不需要管理多个连接——只需专注于构建出色的功能。更多细节请参考官方文档和 GitHub 仓库。