写给前端的 Nest.js 教程——10分钟上手后端接口开发与 TaoToken 统一 Key 配置

1. 前端写接口为什么总卡在第一步Nest.js 到底能帮你做什么如果你写过 Vue 或 React大概率遇到过这种场景页面画完了数据没地方来。要么等后端同事排期要么自己用 Express 随手糊一个app.get(/api/list)结果越写越乱路由、参数校验、数据库操作全堆在一个文件里。Nest.js 就是来解决这个问题的——它把后端项目拆成 Module、Controller、Service 三层每层职责清晰写起来像搭积木。Nest.js 是一个基于 Node.js 的服务端框架底层默认跑 Express也支持 Fastify。它内置 TypeScript 支持用装饰器语法描述路由和依赖注入。对前端来说装饰器不陌生Angular 和 Vue 的 Class API 里都见过类似写法。你不需要理解 IoC 的完整理论只要知道Controller 负责接请求Service 负责干活Module 负责把它们组装在一起。这篇文章面向有前端基础、想快速补齐后端接口能力的开发者。我会带你从零搭一个可运行的 REST 接口服务包含用户增删改查最后把模型调用凭证统一到 TaoToken这样你以后调模型不用到处翻 Key。整个过程 10 分钟左右能跑通代码可以直接复制。适合谁看会 JavaScript/TypeScript、用过 npm、了解 HTTP 基本概念的前端。不需要 MongoDB 经验我会给最简配置。如果你之前只写过前端路由把 Controller 理解成“后端版路由表”就行。2. 环境准备与 TaoToken 统一 Key 配置把模型调用凭证收口在开始写接口之前先把环境搭好。你需要 Node.js 版本 16npm 或 yarn 都行。我习惯用 pnpm但下面命令用 npm 写兼容性最好。第一步安装 Nest CLInpm i -g nestjs/cli nest new nest-api-demo执行后会让你选包管理器选 npm 即可。创建完成后进入目录cd nest-api-demo npm run start:dev看到Nest application successfully started就说明服务跑起来了默认监听 3000 端口。浏览器打开http://localhost:3000会看到 Hello World。接下来处理 TaoToken 的 Key 配置。为什么要在 Nest 项目里配这个因为很多前端同学在写接口时会顺手加一个“调模型”的接口比如让后端代理请求大模型避免把 Key 暴露在浏览器里。这时候如果每个项目都去环境变量里翻 Key很容易乱。TaoToken 提供统一的 API 入口你只需要一个 Key就能在多个项目里复用。先到 TaoToken 控制台创建一个 API Key。地址是https://taotoken.net/api-keys登录后点“创建密钥”复制生成的 Key。注意不要提交到 Git。然后在项目根目录创建.env文件TAOTOKEN_API_KEYsk-你的实际Key TAOTOKEN_BASE_URLhttps://taotoken.net/api安装 dotenv 和 axiosnpm install dotenv axios在src/main.ts顶部引入 dotenvimport dotenv/config; import { NestFactory } from nestjs/core; import { AppModule } from ./app.module; async function bootstrap() { const app await NestFactory.create(AppModule); await app.listen(3000); } bootstrap();这样后续在 Service 里就能通过process.env.TAOTOKEN_API_KEY读取。如果你用的是 Claude Code 或 Cline 这类工具配置方式类似Base URL 填https://taotoken.net/apiKey 填同一个Model ID 按需选择。三件套保持一致切换项目时不用改代码。3. 可复制配置Module/Controller/Service 分层与模型调用片段现在开始写代码。先创建一个用户模块nest g module user nest g controller user nest g service userNest CLI 会自动在src/user下生成三个文件并在app.module.ts里注册 UserModule。打开src/user/user.module.ts确认 imports 里有 UserModule。先定义数据接口。创建src/user/user.interface.tsexport interface User { id: string; name: string; email: string; }为了演示简单我用内存数组存数据不接数据库。创建src/user/user.service.tsimport { Injectable } from nestjs/common; import { User } from ./user.interface; Injectable() export class UserService { private users: User[] [ { id: 1, name: 张三, email: zhangsanexample.com }, ]; findAll(): User[] { return this.users; } findOne(id: string): User { return this.users.find((u) u.id id); } create(user: OmitUser, id): User { const newUser { id: Date.now().toString(), ...user }; this.users.push(newUser); return newUser; } update(id: string, user: PartialUser): User { const index this.users.findIndex((u) u.id id); if (index -1) return null; this.users[index] { ...this.users[index], ...user }; return this.users[index]; } remove(id: string): boolean { const index this.users.findIndex((u) u.id id); if (index -1) return false; this.users.splice(index, 1); return true; } }接着写 Controllersrc/user/user.controller.tsimport { Controller, Get, Post, Put, Delete, Param, Body, } from nestjs/common; import { UserService } from ./user.service; import { User } from ./user.interface; Controller(user) export class UserController { constructor(private readonly userService: UserService) {} Get() findAll(): User[] { return this.userService.findAll(); } Get(:id) findOne(Param(id) id: string): User { return this.userService.findOne(id); } Post() create(Body() body: OmitUser, id): User { return this.userService.create(body); } Put(:id) update(Param(id) id: string, Body() body: PartialUser): User { return this.userService.update(id, body); } Delete(:id) remove(Param(id) id: string): { success: boolean } { return { success: this.userService.remove(id) }; } }现在加一个模型调用接口演示 TaoToken 配置。在src/user/user.service.ts里加一个方法import axios from axios; async chatWithModel(prompt: string): Promisestring { const response await axios.post( ${process.env.TAOTOKEN_BASE_URL}/v1/chat/completions, { model: gpt-4o-mini, messages: [{ role: user, content: prompt }], }, { headers: { Authorization: Bearer ${process.env.TAOTOKEN_API_KEY}, Content-Type: application/json, }, }, ); return response.data.choices[0].message.content; }在 Controller 里加一个 POST 路由Post(chat) async chat(Body(prompt) prompt: string): Promise{ reply: string } { const reply await this.userService.chatWithModel(prompt); return { reply }; }注意Post(chat)要放在Post()之前否则chat会被当成:id参数。这是 Nest 路由匹配顺序的坑我踩过。4. 验证请求与成功结果用 curl 和 Postman 跑通接口服务启动后用 curl 测试。先测用户列表curl http://localhost:3000/user返回[{id:1,name:张三,email:zhangsanexample.com}]创建用户curl -X POST http://localhost:3000/user \ -H Content-Type: application/json \ -d {name:李四,email:lisiexample.com}返回新用户对象id 是时间戳。测试模型调用接口curl -X POST http://localhost:3000/user/chat \ -H Content-Type: application/json \ -d {prompt:用一句话解释什么是REST API}如果配置正确会返回类似{reply:REST API 是一种基于 HTTP 协议的接口设计风格用 URL 定位资源用方法表示操作。}如果报 401检查.env里的 Key 是否复制完整有没有多余空格。如果报Cannot find module dotenv/config确认npm install dotenv执行成功并且main.ts第一行就引入了。Postman 操作更直观新建请求方法选 POSTURL 填http://localhost:3000/user/chatBody 选 raw JSON填入 prompt发送即可。看到 reply 字段就说明整条链路通了。5. 本篇常见错排查401、local proxy failed、reading choices 怎么解第一个常见错误401 Unauthorized。原因通常是 Key 没读到或格式不对。检查.env文件是否在项目根目录main.ts是否在NestFactory.create之前引入了dotenv/config。另外确认请求头是Bearer sk-xxxBearer 和 Key 之间有一个空格。第二个local proxy failed或连接超时。这通常是因为 Base URL 写错了。TaoToken 的 API 地址是https://taotoken.net/api不要多加/v1因为代码里已经拼了/v1/chat/completions。如果你在别的工具里配置比如 Cline 的 MCP 设置Base URL 同样填这个Model ID 按工具要求填。第三个Cannot read properties of undefined (reading choices)。这说明响应结构和你预期的不一样。先打印response.data看看实际返回。常见原因是模型名称写错或者请求体格式不对。TaoToken 兼容 OpenAI 格式messages数组里每条要有role和content。第四个Nest 启动时报Nest cant resolve dependencies of the UserService。检查user.module.ts的 providers 里有没有写 UserServiceController 里有没有通过构造函数注入。Nest 的依赖注入要求显式声明。第五个路由 404。确认 Controller 上的Controller(user)和方法的Get()拼起来的路径。比如Get(:id)会匹配/user/1但不会匹配/user/chat所以 chat 路由要放在前面。如果遇到 OAuth 相关报错比如OAuth token exchange failed那通常是工具侧的认证流程问题和 Nest 代码无关。检查你用的客户端是否支持自定义 Base URLTaoToken 的接入文档里有各工具的配置示例地址是https://taotoken.net/doc。6. 从接口到模型调用把 TaoToken 接入你的日常开发流接口跑通后你可以把 TaoToken 的配置复制到其他项目。比如你在用 Claude Code 做代码补全或者用 Cline 做 Agent 任务Base URL 和 Key 保持一致即可。Coding Plan 适合长期编码场景模型对话适合临时验证API Keys 页面管理所有凭证。我自己的习惯是本地开发用.envCI 环境用环境变量注入永远不把 Key 写进代码。Nest 项目里所有需要调模型的地方都走同一个 Service 方法这样换模型或换供应商时只改一处。最后提醒一点Post(chat)和Post()的顺序问题以及Get(:id)会吞掉后续静态路由这两个坑在新手阶段最容易遇到。记住“具体路径放前面参数路径放后面”就行。代码写完后用npm run start:dev保持热重载改完文件自动重启。测试接口时先看控制台日志Nest 会把每个请求的方法和路径打出来方便定位。如果响应慢先确认是不是模型调用本身耗时可以在 Service 里加console.time打点。到这里一个带用户 CRUD 和模型调用的 Nest 后端就完成了。你可以把它当成模板后续加数据库、加鉴权、加日志都是在这个骨架上扩展。