Nest 实现接口多版本管理

在软件开发中,随着应用的迭代更新,经常需要引入新的接口版本同时保留旧版本以保证向后兼容。

本教程将通过 NestJS 框架演示如何实现接口的多版本管理。

创建和运行项目

首先,我们需要创建一个新的 NestJS 项目,并启动服务:

bash 复制代码
nest new version-test -p pnpm
cd version-test
nest g resource TestVersion --no-spec
pnpm start:dev

启用接口版本控制

main.ts 文件中,引入版本控制功能,并设置版本信息通过 HTTP 头部传递:

typescript 复制代码
import { VersioningType } from '@nestjs/common';
import { AppModule } from './app.module';
import { NestFactory } from '@nestjs/core';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  app.enableVersioning({
    type: VersioningType.HEADER,
    header: 'version', // 指定传递版本信息的 HTTP 头部字段名为 'version'
  });

  await app.listen(3000);
}

bootstrap();

配置版本控制

在控制器中,我们可以通过 @Version 装饰器指定接口版本。

例如,将默认接口设置为版本 1,并为新版本创建专门的接口:

typescript 复制代码
import { Controller, Get, Version } from '@nestjs/common';
import { TestVersionService } from './test-version.service';

@Controller('test-version')
export class TestVersionController {
  constructor(private readonly testVersionService: TestVersionService) {}

  @Get()
  @Version('1')
  findAllV1() {
    return this.testVersionService.findAll();
  }

  @Get()
  @Version('2')
  findAllV2() {
    return this.testVersionService.findAll() + '版本2';
  }
}


带上不同的请求头,获得的结果不一样。

版本中立的接口

如果希望某些接口无论什么版本号如何都能访问,可以使用 VERSION_NEUTRAL 常量:

typescript 复制代码
import { VERSION_NEUTRAL, Controller, Get } from '@nestjs/common';

@Controller({
  path: 'test-version',
  version: VERSION_NEUTRAL
})
export class NeutralAaaController {
  // 接口实现
}

其他版本控制方式

NestJS 还支持通过媒体类型(Media Type)或 URI 路径来控制版本:

Media Type

版本信息通过 Accept 头部传递:

typescript 复制代码
app.enableVersioning({
    type: VersioningType.MEDIA_TYPE,
    key: 'vvv='
})

如果客户端希望请求版本 1 的 API,它需要在 HTTP 请求的 Accept 头部中加入如下内容:

bash 复制代码
Accept: application/json;vvv=1

URI 版本控制

版本信息直接在 URL 路径中指定:

typescript 复制代码
app.enableVersioning({
  type: VersioningType.URI,
});

在这个设置下,如果客户端需要访问版本 1 的 API,URL 应该像这样:

bash 复制代码
http://localhost:3000/v1/users

对于版本 2,URL 应该是:

bash 复制代码
http://localhost:3000/v2/users

这种方式使得版本控制非常明显,客户端一看 URL 就能明白所请求的 API 版本。但可能会导致 URL 空间的膨胀。

注意这种方式不支持 VERSION_NEUTRAL,需要明确版本号:

typescript 复制代码
@Controller({
  path: 'test-version',
  version: ["2", "3"]
})

自定义版本控制逻辑

如果内置的版本控制方式不满足需求,可以实现自定义版本控制逻辑:

typescript 复制代码
import { VersioningType, NestFactory } from '@nestjs/common';
import { AppModule } from './app.module';
import { Request } from 'express';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  const extractor = (request: Request) => {
    if (request.headers['disable-custom']) {
      return '';
    }
    return request.url.includes('yun') ? '2' : '1';
  };
  app.enableVersioning({
    type: VersioningType.CUSTOM,
    extractor
  });
  await app.listen(3000);
}

bootstrap();



相关推荐
并不会39 分钟前
常见 CSS 选择器用法
前端·css·学习·html·前端开发·css选择器
衣乌安、42 分钟前
【CSS】居中样式
前端·css·css3
兔老大的胡萝卜42 分钟前
ppk谈JavaScript,悟透JavaScript,精通CSS高级Web,JavaScript DOM编程艺术,高性能JavaScript pdf
前端·javascript
低代码布道师1 小时前
CSS的三个重点
前端·css
耶啵奶膘2 小时前
uniapp-是否删除
linux·前端·uni-app
NiNg_1_2343 小时前
SpringBoot整合SpringSecurity实现密码加密解密、登录认证退出功能
java·spring boot·后端
王哈哈^_^4 小时前
【数据集】【YOLO】【目标检测】交通事故识别数据集 8939 张,YOLO道路事故目标检测实战训练教程!
前端·人工智能·深度学习·yolo·目标检测·计算机视觉·pyqt
Chrikk4 小时前
Go-性能调优实战案例
开发语言·后端·golang
幼儿园老大*4 小时前
Go的环境搭建以及GoLand安装教程
开发语言·经验分享·后端·golang·go
canyuemanyue4 小时前
go语言连续监控事件并回调处理
开发语言·后端·golang