一篇文章学会如何在 NestJS 中使用 Redis 并基于 Redis 实现接口访问限频率

前言

在处理高频数据操作和大规模并发请求的场合,我们需要一种机制能够快速读取和缓存数据,这时 Redis 就闪亮登场了。Redis 是一个开源的内存中数据结构存储系统,它可以用作数据库、缓存和消息中间件。

NestJS 是一个灵活且模块化的Node.js框架,它借鉴了Angular的设计哲学,提出了控制器、提供者和模块的概念,这为我们集成和使用Redis提供了便利。本文介绍如何在NestJS框架中集成Redis,并通过实际案例来展示使用Redis的优势。

集成步骤

一、 安装必要的包

在开始之前,我们需要在NestJS项目中安装 Redis 和 NestJS 对应的 Redis 模块。

npm install redis ioredis @nestjs-modules/ioredis @nestjs/common

这里我们使用 ioredis,因为它是一个健壮的、功能全面的 Redis 客户端,与 nest-modules相关联。

二、创建 Redis 模块

接下来,我们需要在 NestJS 应用中创建一个 Redis 模块。

// redis.module.ts
import { Module } from '@nestjs/common';
import { RedisModule } from '@nestjs-modules/ioredis';

@Module({
  imports: [
    RedisModule.forRoot({
      config: {
        host: 'localhost', // Redis 服务器地址
        port: 6379,       // Redis 端口
        password: 'your_password', // 如果有设置密码的话
        db: 0,           // 如果你需要使用特定的数据库的话
      },
    }),
  ],
})
export class RedisCacheModule {}

在这个模块中,我们导入并配置了 Redis。我们需要确保这些配置与你的 Redis 服务器设置匹配。

三、在服务中使用 Redis

配置好模块后,我们可以在服务中注入 Redis 客户端,并开始实现业务逻辑。

// app.service.ts
import { Injectable } from '@nestjs/common';
import { InjectRedis, Redis } from '@nestjs-modules/ioredis';

@Injectable()
export class AppService {
  constructor(@InjectRedis() private readonly redis: Redis) {}

  async getHello(): Promise<string> {
    // 使用 Redis 设置值
    await this.redis.set('hello', 'Hello from Redis!');
    // 使用 Redis 获取值
    return this.redis.get('hello');
  }

  // ... 其他业务逻辑 ...
}

在这个服务中,我们注入了 Redis 客户端,并在 getHello方法中演示了如何设置和获取缓存。

四、控制器 Controller 调用服务

最后,让我们来创建一个控制器调用这个服务。

// app.controller.ts
import { Controller, Get } from '@nestjs/common';
import { AppService } from './app.service';

@Controller()
export class AppController {
  constructor(private readonly appService: AppService) {}

  @Get()
  getHello(): Promise<string> {
    return this.appService.getHello();
  }
}

控制器非常简单,它使用 @Get()装饰器来处理根路由的 GET 请求,并调用 appService中的 getHello方法。

功能实现

通过将Redis集成到NestJS中,我们可以实现以下需求:

  1. 数据缓存:存储经常查询的数据提高处理速度。
  2. 会话管理:用Redis存储session信息,实现无状态的负载均衡。
  3. 排行榜系统:Redis的Sorted Set非常适合做排名操作。
  4. 发布/订阅:利用 Redis 实现分工系统,用于消息的异步处理。
  5. 限流:通过Redis的INCR和EXPIRE命令来实现API的限流。
  6. 作业队列:使用 Redis 的列表结构实现一个简单的作业队列。

实战:接口访问限制频率

为了控制访问速率并避免应用被过多的请求淹没,我们可以利用 Redis 来为我们的 API 接口实现限流功能。下面是一个简化的例子:

步骤一:实现限流拦截器

// api-rate-limiter.interceptor.ts
import {
  Injectable,
  NestInterceptor,
  ExecutionContext,
  CallHandler,
  HttpException,
  HttpStatus,
} from '@nestjs/common';
import { Observable } from 'rxjs';
import { InjectRedis, Redis } from '@nestjs-modules/ioredis';
import { tap } from 'rxjs/operators';

@Injectable()
export class ApiRateLimiterInterceptor implements NestInterceptor {
  constructor(@InjectRedis() private readonly redis: Redis) {}

  async intercept(context: ExecutionContext, next: CallHandler): Promise<Observable<any>> {
    const key = 'rate-limit:' + context.switchToHttp().getRequest().ip;
    const currentRequestCount = await this.redis.incr(key);

    if (currentRequestCount === 1) {
      // 设置 key 的超时时间
      await this.redis.expire(key, 60); // 限流周期为 60 秒
    }

    if (currentRequestCount > 10) {
      throw new HttpException('Too many requests', HttpStatus.TOO_MANY_REQUESTS);
    }

    return next.handle().pipe(
      tap(() => {
        // 在响应完成后,你可以在这里执行一些操作。
      }),
    );
  }
}

要实现的这个拦截器会检查每个 IP 地址每分钟发出的请求,并且如果请求超过10次,将会抛出 429 Too Many Requests 错误。

步骤二:项目中使用限流拦截器

将这个拦截器中间件引入到你的应用中,可以在对应的控制器或全局应用中注册。

// 在主模块中全局注册
import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common';
import { ApiRateLimiterInterceptor } from './api-rate-limiter.interceptor';

@Module({
  // ...
})
export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer
      .apply(ApiRateLimiterInterceptor)
      .forRoutes('*'); // 应用到所有的路由
  }
}

或者在特定的控制器上使用:

// app.controller.ts
import { Controller, UseInterceptors, Get } from '@nestjs/common';
import { ApiRateLimiterInterceptor } from './api-rate-limiter.interceptor';

@Controller()
@UseInterceptors(ApiRateLimiterInterceptor)
export class AppController {
  // ...
}

总结

通过在 NestJS 中集成 Redis,我们不仅可以实现上述功能,还能设计更复杂的系统,如分布式系统通信、实时数据分析等等。Redis 的快速、灵活性加上 NestJS 的架构,能够让你的 Web 应用性能达到一个新的层次。

你可能感兴趣的:(NestJS,最佳实践手册,node.js,nest.js,redis,nestjs,权限认证,缓存)