使用 Nest.js 设计 RBAC 权限系统：分步指南-js教程-PHP中文网

Designing RBAC Permission System with Nest.js: A Step-by-Step Guide

前言

对于后端管理系统，访问控制和个性化用户界面等功能至关重要。例如，超级管理员可以查看所有页面，普通用户可以访问A、B页面，VIP用户可以查看A、B、C、D页面。这些功能背后的逻辑基于三个关键概念的设计：

用户：基本单位，如Alice、Bob、Charlie。
角色：用户可以拥有一个或多个角色。例如，Alice 可能同时拥有普通用户和 VIP 的角色。
权限：一个角色关联多个权限。例如，VIP角色可能具有查看、编辑和添加的权限，而超级管理员可以查看、编辑、添加和删除。

关系可以用下图来说明：

Designing RBAC Permission System with Nest.js: A Step-by-Step Guide

接下来，我们将使用Nest从头开始实现这样一个系统的基础——权限设计。

创建数据库

首先，我们需要创建数据库。我们将使用 MySQL 数据库并执行以下命令来创建它：

CREATE DATABASE `nest-database` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

登录后复制

项目初始化

我们将通过运行以下命令启动一个新的 Nest 项目：

nest new nest-project

登录后复制

然后，安装必要的数据库依赖项，主要是 typeorm 和 mysql2：

npm install --save @nestjs/typeorm typeorm mysql2

登录后复制

接下来，在app.module.ts中配置typeorm：

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { TypeOrmModule } from '@nestjs/typeorm';

@Module({
  imports: [
    TypeOrmModule.forRoot({
      type: 'mysql',
      host: 'localhost',
      port: 3306,
      username: 'root',
      password: 'password',
      database: 'nest-database',
      synchronize: true,
      logging: true,
      entities: [__dirname + '/**/*.entity{.ts,.js}'],
      poolSize: 10,
      connectorPackage: 'mysql2',
    }),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

登录后复制

桌子设计

通常，RBAC（基于角色的访问控制）系统将有 5 个表，如下所示：

用户表（用户）：存储用户基本信息，如用户名、密码和电子邮件。
角色表（角色）：存储角色详细信息，例如角色名称和角色代码。
权限表（权限）：存储权限详细信息，例如权限名称和权限代码。
用户角色关系表（user_role_relation）：跟踪用户和角色之间的关系。
角色权限关系表（role_permission_relation）：跟踪角色和权限之间的关系。

领域模型可以可视化如下：

Designing RBAC Permission System with Nest.js: A Step-by-Step Guide

接下来，我们将在 Nest 中创建三个非关系表并定义它们的关系。

用户.实体.ts：

CREATE DATABASE `nest-database` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

登录后复制

在User表中，定义了roles字段来连接user_role_relation表。关系逻辑为：user.id === userRoleRelation.userId 和 role.id === userRoleRelation.roleId。匹配的角色记录会自动链接到用户。

角色.实体.ts：

nest new nest-project

登录后复制

角色表中的权限字段的工作原理类似。它使用以下逻辑与 role_permission_relation 表连接： role.id === rolePermissionRelation.roleId 和permission.id === rolePermissionRelation.permissionId。

权限.entity.ts:

npm install --save @nestjs/typeorm typeorm mysql2

登录后复制

权限表没有关系；它只是记录可用的权限。

数据初始化

这是一个用于初始化一些测试数据的服务：

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { TypeOrmModule } from '@nestjs/typeorm';

@Module({
  imports: [
    TypeOrmModule.forRoot({
      type: 'mysql',
      host: 'localhost',
      port: 3306,
      username: 'root',
      password: 'password',
      database: 'nest-database',
      synchronize: true,
      logging: true,
      entities: [__dirname + '/**/*.entity{.ts,.js}'],
      poolSize: 10,
      connectorPackage: 'mysql2',
    }),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

登录后复制

通过浏览器或Postman运行initData服务，数据将填充数据库。

Designing RBAC Permission System with Nest.js: A Step-by-Step Guide