1. 为什么要在 Node.js 后端选型里先跑通双框架对照 DemoNode.js 后端选型这件事真正让人纠结的往往不是“Express 和 NestJS 谁更好”而是“我能不能在同一个环境里用同一套模型调用方式把两个框架的最小可运行版本都跑起来然后拿真实请求结果做对比”。如果你只是看文章里的对比表格很容易得出“小项目 Express、大项目 NestJS”这种正确但没法落地的结论。因为路由怎么写、中间件怎么挂、依赖注入到底解决了什么问题这些差异只有在你亲手启动两个服务、用 curl 打到同一个接口、看到返回结构之后才会变成你自己的判断。这篇内容聚焦的就是这个场景Node.js 后端选型。我会带你从零初始化两个项目一个是 Express一个是 NestJS两者都接入同一套模型调用配置用统一的 Key 和 Base URL 去请求模型最后分别用 curl 验证接口返回。这样你得到的不是两段孤立的示例代码而是一组可以横向对照的 Demo同样的业务需求比如让接口调用模型返回一段文本在 Express 里怎么组织在 NestJS 里又怎么组织。核心检索词先明确NestJS 和 Express 都是基于 Node.js 的后端框架NestJS 是架构型框架内置模块化、依赖注入、装饰器Express 是轻量级 Web 框架灵活、抽象少、上手快。本文要交付的是两套可复制的项目初始化配置以及统一 Key 接入示例并给出启动后验证接口返回的 curl 动作。适合谁适合正在做 Node.js 后端选型、想快速跑通双框架对照 Demo 的后端开发者也适合已经会 Express、想看看 NestJS 的依赖注入到底长什么样的同学。我试过把两个框架放在同一个工作目录下并行开发最大的感受是Express 的自由度会让你在早期跑得飞快但当你需要给接口加统一鉴权、参数校验、日志拦截时你得自己设计一套约定NestJS 前期配置多但它的 Guard、Pipe、Interceptor 这些概念一旦用起来后面加功能是“往架构里填东西”而不是“在自由代码里找地方塞”。这篇文章不替你下结论而是把两条路都铺好让你自己走一遍。在开始之前你需要准备的东西很简单Node.js 18 以上、npm 或 pnpm、一个可用的模型调用 Key后面会讲怎么统一管理、以及 curl 或 Postman 用来验证。两个项目我会分别放在express-demo和nestjs-demo目录下端口错开避免冲突。接下来先讲统一 Key 的接入前置再分别给两套配置最后做验证和排错。2. TaoToken 统一 Key 接入前置Base URL、API Key 与模型 ID 三件套在跑双框架 Demo 之前先把模型调用这一层统一掉。不管你用 Express 还是 NestJS最终都是发一个 HTTP 请求到模型服务所以只要把 Base URL、API Key、Model ID 这三件套固定下来两个框架里就可以用同一套配置甚至可以把这段调用逻辑抽成一个共享模块。这里我用 TaoToken 作为统一入口官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址后面不加 UTM 参数。先说清楚这三件套分别是什么。Base URL 是请求的根地址OpenAI 兼容风格的接口通常会在后面拼/v1/chat/completionsAPI Key 是身份凭证放在请求头Authorization: Bearer key里Model ID 是你要调用的具体模型标识不同模型 ID 对应不同的能力和价格。这三者缺一不可而且必须匹配Base URL 指向的服务要能识别你的 KeyKey 要有权限调用你写的 Model ID。获取 Key 的路径很直接打开 https://taotoken.net/api-keys 登录后创建一个新的 API Key复制出来保存好。注意 Key 只在创建时完整显示一次丢了就只能重建。创建完之后你可以在控制台 https://taotoken.net/console 看到自己的用量和调用记录方便排查问题。如果你只是想先验证模型能不能通可以打开模型对话页面 https://taotoken.net/chat 直接发一条消息确认账号和模型都正常再去写代码。这里有一个容易踩的坑很多人把 Base URL 写成https://taotoken.net/api/v1或者https://taotoken.net/v1结果请求 404。正确的做法是 Base URL 用https://taotoken.net/api然后在代码里拼接/v1/chat/completions或者你用的 SDK 会自动帮你拼。如果你用的是 OpenAI 官方 SDK通常配置baseURL: https://taotoken.net/api/v1也能工作因为 SDK 会在后面拼/chat/completions。两种写法取决于你用的客户端关键是最终请求的完整路径要对。为了在两个框架里复用我建议把配置放到环境变量里而不是硬编码。在项目根目录建一个.env文件内容如下TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_API_KEYsk-你的实际Key TAOTOKEN_MODEL_ID你的模型ID然后在代码里用process.env.TAOTOKEN_BASE_URL读取。Express 项目里可以用dotenv加载NestJS 里可以用nestjs/config加载。这样两个项目共享同一份配置思路切换环境时只改.env不用动代码。注意.env不要提交到 git记得加进.gitignore。如果你打算长期做编码类任务或者 Agent 开发可以了解一下 Coding Plan https://taotoken.net/coding-plan 它更适合持续性的代码生成场景。但本文的 Demo 用按量调用的 API Key 就够了。另外如果你用 Claude Code 这类工具它的接入文档在 https://taotoken.net/doc 里面有更详细的配置说明。总之先把三件套准备好接下来两套框架的代码都会围绕这三个变量展开。3. 可复制配置Express 与 NestJS 双项目初始化与统一调用模块这一节是全文的核心操作部分我会分别给出 Express 和 NestJS 的完整初始化配置并且把模型调用抽成一个可复用的模块。两个项目都放在同一个父目录下端口分别用 3000 和 3001避免冲突。3.1 Express 项目初始化与路由、中间件配置先建 Express 项目。打开终端执行mkdir express-demo cd express-demo npm init -y npm install express dotenv npm install -D nodemon然后在package.json里加上启动脚本注意type设为module这样可以用 ESM 语法{ name: express-demo, version: 1.0.0, type: module, scripts: { dev: nodemon src/server.js, start: node src/server.js }, dependencies: { dotenv: ^16.4.5, express: ^4.19.2 }, devDependencies: { nodemon: ^3.1.0 } }创建目录结构src/server.js、src/routes/chat.js、src/services/modelService.js、.env。先写模型调用服务src/services/modelService.jsimport dotenv/config; const BASE_URL process.env.TAOTOKEN_BASE_URL; const API_KEY process.env.TAOTOKEN_API_KEY; const MODEL_ID process.env.TAOTOKEN_MODEL_ID; export async function chatWithModel(prompt) { const response await fetch(${BASE_URL}/v1/chat/completions, { method: POST, headers: { Content-Type: application/json, Authorization: Bearer ${API_KEY} }, body: JSON.stringify({ model: MODEL_ID, messages: [{ role: user, content: prompt }], temperature: 0.7 }) }); if (!response.ok) { const errText await response.text(); throw new Error(模型请求失败: ${response.status} ${errText}); } const data await response.json(); return data.choices[0].message.content; }这里用的是 Node.js 18 内置的fetch不需要额外装 axios。注意BASE_URL后面拼的是/v1/chat/completions和前面说的路径规则一致。接着写路由src/routes/chat.jsimport { Router } from express; import { chatWithModel } from ../services/modelService.js; const router Router(); router.post(/chat, async (req, res) { const { prompt } req.body; if (!prompt) { return res.status(400).json({ error: prompt 不能为空 }); } try { const reply await chatWithModel(prompt); res.json({ framework: express, reply }); } catch (err) { res.status(500).json({ error: err.message }); } }); export default router;最后是入口src/server.js这里演示 Express 的中间件挂载方式import express from express; import chatRouter from ./routes/chat.js; const app express(); const PORT 3000; // 中间件解析 JSON 请求体 app.use(express.json()); // 中间件简单请求日志 app.use((req, res, next) { console.log([${new Date().toISOString()}] ${req.method} ${req.url}); next(); }); // 挂载路由 app.use(/api, chatRouter); app.listen(PORT, () { console.log(Express 服务已启动: http://localhost:${PORT}); });可以看到 Express 的中间件就是app.use()按顺序挂载路由用Router组织业务逻辑放在 service 里但框架本身不强制你这么做。启动用npm run dev。3.2 NestJS 项目初始化与模块、控制器、服务三层结构NestJS 用 CLI 初始化最省事。先全局装 CLI或者用 npxnpx nestjs/cli new nestjs-demo cd nestjs-demo npm install nestjs/config创建时选择 npm 作为包管理器。初始化完成后目录结构已经自带src/app.module.ts、src/app.controller.ts、src/app.service.ts。我们要新增一个 chat 模块。用 CLI 生成npx nest generate module chat npx nest generate controller chat npx nest generate service chat这会在src/chat/下生成三个文件。先配置环境变量在src/app.module.ts里引入ConfigModuleimport { Module } from nestjs/common; import { ConfigModule } from nestjs/config; import { AppController } from ./app.controller; import { AppService } from ./app.service; import { ChatModule } from ./chat/chat.module; Module({ imports: [ ConfigModule.forRoot({ isGlobal: true }), ChatModule ], controllers: [AppController], providers: [AppService] }) export class AppModule {}然后写src/chat/chat.service.ts这里体现依赖注入和业务逻辑封装import { Injectable, InternalServerErrorException } from nestjs/common; import { ConfigService } from nestjs/config; Injectable() export class ChatService { constructor(private configService: ConfigService) {} async chatWithModel(prompt: string): Promisestring { const baseUrl this.configService.getstring(TAOTOKEN_BASE_URL); const apiKey this.configService.getstring(TAOTOKEN_API_KEY); const modelId this.configService.getstring(TAOTOKEN_MODEL_ID); const response await fetch(${baseUrl}/v1/chat/completions, { method: POST, headers: { Content-Type: application/json, Authorization: Bearer ${apiKey} }, body: JSON.stringify({ model: modelId, messages: [{ role: user, content: prompt }], temperature: 0.7 }) }); if (!response.ok) { const errText await response.text(); throw new InternalServerErrorException(模型请求失败: ${response.status} ${errText}); } const data await response.json(); return data.choices[0].message.content; } }控制器src/chat/chat.controller.ts只负责接收请求和返回响应import { Body, Controller, Post } from nestjs/common; import { ChatService } from ./chat.service; Controller(api/chat) export class ChatController { constructor(private readonly chatService: ChatService) {} Post() async chat(Body(prompt) prompt: string) { if (!prompt) { return { error: prompt 不能为空 }; } const reply await this.chatService.chatWithModel(prompt); return { framework: nestjs, reply }; } }模块文件src/chat/chat.module.ts把三者组装起来import { Module } from nestjs/common; import { ChatController } from ./chat.controller; import { ChatService } from ./chat.service; Module({ controllers: [ChatController], providers: [ChatService] }) export class ChatModule {}最后改一下src/main.ts把端口设为 3001import { NestFactory } from nestjs/core; import { AppModule } from ./app.module; async function bootstrap() { const app await NestFactory.create(AppModule); await app.listen(3001); console.log(NestJS 服务已启动: http://localhost:3001); } bootstrap();启动用npm run start:dev。对比一下就能看出差异Express 里路由、中间件、业务逻辑的边界靠你自己划NestJS 里 Controller 只处理请求Service 封装业务Module 负责组装依赖注入让 Service 可以被替换和测试。这就是“架构驱动”和“工具库”的区别。4. 验证请求用 curl 分别打两个框架的接口并对照返回两个服务都启动后先确认端口Express 在 3000NestJS 在 3001。验证接口返回用 curl 最直接不需要打开 Postman。先打 Expresscurl -X POST http://localhost:3000/api/chat \ -H Content-Type: application/json \ -d {prompt:用一句话解释什么是依赖注入}预期返回类似{ framework: express, reply: 依赖注入是一种设计模式它把对象的依赖关系交给外部容器来创建和传递而不是在对象内部自己 new。 }再打 NestJScurl -X POST http://localhost:3001/api/chat \ -H Content-Type: application/json \ -d {prompt:用一句话解释什么是依赖注入}预期返回{ framework: nestjs, reply: 依赖注入是一种设计模式它把对象的依赖关系交给外部容器来创建和传递而不是在对象内部自己 new。 }两个返回的framework字段不同方便你确认请求打到了哪个服务reply内容来自同一个模型所以语义一致。如果你看到reply是空字符串或者报错先检查.env里的三件套是否正确尤其是 API Key 有没有多余空格。除了 curl你也可以用 REST Client 插件在 VS Code 里建一个.http文件把上面两段请求写进去点一下就能发。这种方式在反复调试时比复制 curl 命令更顺手。验证通过后你可以试着改一下 prompt比如让它返回 JSON 格式观察两个框架对返回内容的处理方式是否一致——实际上它们都只是把模型返回的字符串透传出去差异在框架层不在模型层。这里再补充一个对照点如果你在 Express 里想加一个统一的请求日志你写了一个app.use在 NestJS 里对应的概念是 Middleware 或 Interceptor。你可以试着在 NestJS 里加一个 Interceptor记录每个请求的耗时然后对比 Express 里用中间件实现同样功能的代码量。这个练习能让你直观感受到 NestJS 的“结构化扩展”和 Express 的“自由拼装”各自的手感。验证成功后建议把两个服务的启动命令分别记下来后面做选型对比时随时可以拉起来。如果你还想验证更多模型或对比不同 Model ID 的输出可以打开模型对话页面 https://taotoken.net/chat 快速试不用每次都改代码。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth 报错跑双框架 Demo 时报错基本集中在模型调用这一层因为框架本身的启动问题比较直观。下面按真实报错逐个排查。401 Unauthorized。这是最常见的返回体里通常有invalid api key或unauthorized。原因有三个Key 复制错了、Key 前后有空格、.env没被正确加载。先检查process.env.TAOTOKEN_API_KEY是否真的有值可以在服务启动时打印一下前几位不要打印完整 Key。Express 里确认import dotenv/config在文件顶部NestJS 里确认ConfigModule.forRoot({ isGlobal: true })已经引入。如果 Key 确认没问题检查请求头是不是Authorization: Bearer key少个空格也会 401。local proxy failed。这个报错通常出现在你本地网络环境有代理设置或者请求地址被解析到了错误的地方。先确认TAOTOKEN_BASE_URL是https://taotoken.net/api没有多余路径。然后检查你的终端或系统环境变量里有没有HTTP_PROXY、HTTPS_PROXY这类设置如果有临时取消掉再试。Node.js 的fetch会读取环境变量里的代理配置如果代理不可用就会报这个错。另外如果你在容器里跑确认容器能正常访问外网。Cannot read properties of undefined (reading choices)。这个报错说明data.choices是 undefined也就是返回体结构和你预期的不一样。常见原因是请求路径拼错了比如 Base URL 写成了https://taotoken.net/api/v1然后代码里又拼了/v1/chat/completions变成/api/v1/v1/chat/completions服务返回了错误信息而不是正常的 choices 结构。解决办法是打印完整的data看看实际返回了什么然后调整路径。正确的组合是 Base URLhttps://taotoken.net/api 代码里拼/v1/chat/completions。OAuth 相关报错。如果你用的是某些 CLI 工具或 SDK可能会遇到 OAuth 认证失败。这类工具通常有自己的登录流程和 API Key 是两套体系。如果你只是想用 API Key 调用确认工具配置里选择的是 API Key 模式而不是 OAuth 模式。对于 Claude Code 这类工具接入文档在 https://taotoken.net/doc 里面有具体的配置说明。如果你在 NestJS 里用了某个 SDK 报 OAuth 错先换成直接用fetch发请求排除 SDK 配置问题。端口占用。Express 默认 3000NestJS 默认 3000如果你先启动了 Express 再启动 NestJSNestJS 会报EADDRINUSE。解决办法是在main.ts里把 NestJS 端口改成 3001或者启动前先确认端口空闲。这个错和模型调用无关但很容易在双项目并行时遇到。模型 ID 不存在。返回体里会有model not found之类的提示。检查TAOTOKEN_MODEL_ID是否拼写正确注意大小写和连字符。你可以在控制台 https://taotoken.net/console 查看可用模型列表或者直接在模型对话页面试一下这个 Model ID 能不能用。排查顺序建议先看 HTTP 状态码401 查 Key404 查路径500 查模型返回体。把完整错误信息打印出来比猜要快得多。如果你在 NestJS 里看到异常被包装成了InternalServerErrorException可以在ChatService里先把原始错误console.error出来再抛出去这样排查更方便。6. 继续深入把双框架 Demo 扩展成可对比的选型基线跑通上面的 Demo 之后你手里就有了一条可对比的基线同样的模型调用Express 用路由 中间件 service 组织NestJS 用模块 控制器 服务 依赖注入组织。接下来你可以在这条基线上加东西观察两个框架的扩展成本。比如加一个统一的鉴权Express 里写一个中间件检查请求头里的 tokenNestJS 里写一个 Guard两者代码量差不多但 NestJS 的 Guard 可以被更细粒度地绑定到控制器或方法上。再加一个参数校验Express 里你可能用 zod 或 joi 手动校验NestJS 里用 ValidationPipe 配合 DTO 类声明式更强。如果你打算长期做编码类任务或者要把这套 Demo 扩展成 Agent 服务可以看看 Coding Plan https://taotoken.net/coding-plan 它在持续调用场景下更合适。需要新的 API Key 时直接去 https://taotoken.net/api-keys 创建想快速验证模型输出用 https://taotoken.net/chat 完整的接入文档在 https://taotoken.net/doc 。把这两个项目留在你的工作目录里下次做技术选型时直接拉起来改一改比重新搭环境快得多。 基于 Node.js 的后端框架：NestJS 和 Express（一）——用 TaoToken 统一 Key 跑通双框架示例
1. 为什么要在 Node.js 后端选型里先跑通双框架对照 DemoNode.js 后端选型这件事真正让人纠结的往往不是“Express 和 NestJS 谁更好”而是“我能不能在同一个环境里用同一套模型调用方式把两个框架的最小可运行版本都跑起来然后拿真实请求结果做对比”。如果你只是看文章里的对比表格很容易得出“小项目 Express、大项目 NestJS”这种正确但没法落地的结论。因为路由怎么写、中间件怎么挂、依赖注入到底解决了什么问题这些差异只有在你亲手启动两个服务、用 curl 打到同一个接口、看到返回结构之后才会变成你自己的判断。这篇内容聚焦的就是这个场景Node.js 后端选型。我会带你从零初始化两个项目一个是 Express一个是 NestJS两者都接入同一套模型调用配置用统一的 Key 和 Base URL 去请求模型最后分别用 curl 验证接口返回。这样你得到的不是两段孤立的示例代码而是一组可以横向对照的 Demo同样的业务需求比如让接口调用模型返回一段文本在 Express 里怎么组织在 NestJS 里又怎么组织。核心检索词先明确NestJS 和 Express 都是基于 Node.js 的后端框架NestJS 是架构型框架内置模块化、依赖注入、装饰器Express 是轻量级 Web 框架灵活、抽象少、上手快。本文要交付的是两套可复制的项目初始化配置以及统一 Key 接入示例并给出启动后验证接口返回的 curl 动作。适合谁适合正在做 Node.js 后端选型、想快速跑通双框架对照 Demo 的后端开发者也适合已经会 Express、想看看 NestJS 的依赖注入到底长什么样的同学。我试过把两个框架放在同一个工作目录下并行开发最大的感受是Express 的自由度会让你在早期跑得飞快但当你需要给接口加统一鉴权、参数校验、日志拦截时你得自己设计一套约定NestJS 前期配置多但它的 Guard、Pipe、Interceptor 这些概念一旦用起来后面加功能是“往架构里填东西”而不是“在自由代码里找地方塞”。这篇文章不替你下结论而是把两条路都铺好让你自己走一遍。在开始之前你需要准备的东西很简单Node.js 18 以上、npm 或 pnpm、一个可用的模型调用 Key后面会讲怎么统一管理、以及 curl 或 Postman 用来验证。两个项目我会分别放在express-demo和nestjs-demo目录下端口错开避免冲突。接下来先讲统一 Key 的接入前置再分别给两套配置最后做验证和排错。2. TaoToken 统一 Key 接入前置Base URL、API Key 与模型 ID 三件套在跑双框架 Demo 之前先把模型调用这一层统一掉。不管你用 Express 还是 NestJS最终都是发一个 HTTP 请求到模型服务所以只要把 Base URL、API Key、Model ID 这三件套固定下来两个框架里就可以用同一套配置甚至可以把这段调用逻辑抽成一个共享模块。这里我用 TaoToken 作为统一入口官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址后面不加 UTM 参数。先说清楚这三件套分别是什么。Base URL 是请求的根地址OpenAI 兼容风格的接口通常会在后面拼/v1/chat/completionsAPI Key 是身份凭证放在请求头Authorization: Bearer key里Model ID 是你要调用的具体模型标识不同模型 ID 对应不同的能力和价格。这三者缺一不可而且必须匹配Base URL 指向的服务要能识别你的 KeyKey 要有权限调用你写的 Model ID。获取 Key 的路径很直接打开 https://taotoken.net/api-keys 登录后创建一个新的 API Key复制出来保存好。注意 Key 只在创建时完整显示一次丢了就只能重建。创建完之后你可以在控制台 https://taotoken.net/console 看到自己的用量和调用记录方便排查问题。如果你只是想先验证模型能不能通可以打开模型对话页面 https://taotoken.net/chat 直接发一条消息确认账号和模型都正常再去写代码。这里有一个容易踩的坑很多人把 Base URL 写成https://taotoken.net/api/v1或者https://taotoken.net/v1结果请求 404。正确的做法是 Base URL 用https://taotoken.net/api然后在代码里拼接/v1/chat/completions或者你用的 SDK 会自动帮你拼。如果你用的是 OpenAI 官方 SDK通常配置baseURL: https://taotoken.net/api/v1也能工作因为 SDK 会在后面拼/chat/completions。两种写法取决于你用的客户端关键是最终请求的完整路径要对。为了在两个框架里复用我建议把配置放到环境变量里而不是硬编码。在项目根目录建一个.env文件内容如下TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_API_KEYsk-你的实际Key TAOTOKEN_MODEL_ID你的模型ID然后在代码里用process.env.TAOTOKEN_BASE_URL读取。Express 项目里可以用dotenv加载NestJS 里可以用nestjs/config加载。这样两个项目共享同一份配置思路切换环境时只改.env不用动代码。注意.env不要提交到 git记得加进.gitignore。如果你打算长期做编码类任务或者 Agent 开发可以了解一下 Coding Plan https://taotoken.net/coding-plan 它更适合持续性的代码生成场景。但本文的 Demo 用按量调用的 API Key 就够了。另外如果你用 Claude Code 这类工具它的接入文档在 https://taotoken.net/doc 里面有更详细的配置说明。总之先把三件套准备好接下来两套框架的代码都会围绕这三个变量展开。3. 可复制配置Express 与 NestJS 双项目初始化与统一调用模块这一节是全文的核心操作部分我会分别给出 Express 和 NestJS 的完整初始化配置并且把模型调用抽成一个可复用的模块。两个项目都放在同一个父目录下端口分别用 3000 和 3001避免冲突。3.1 Express 项目初始化与路由、中间件配置先建 Express 项目。打开终端执行mkdir express-demo cd express-demo npm init -y npm install express dotenv npm install -D nodemon然后在package.json里加上启动脚本注意type设为module这样可以用 ESM 语法{ name: express-demo, version: 1.0.0, type: module, scripts: { dev: nodemon src/server.js, start: node src/server.js }, dependencies: { dotenv: ^16.4.5, express: ^4.19.2 }, devDependencies: { nodemon: ^3.1.0 } }创建目录结构src/server.js、src/routes/chat.js、src/services/modelService.js、.env。先写模型调用服务src/services/modelService.jsimport dotenv/config; const BASE_URL process.env.TAOTOKEN_BASE_URL; const API_KEY process.env.TAOTOKEN_API_KEY; const MODEL_ID process.env.TAOTOKEN_MODEL_ID; export async function chatWithModel(prompt) { const response await fetch(${BASE_URL}/v1/chat/completions, { method: POST, headers: { Content-Type: application/json, Authorization: Bearer ${API_KEY} }, body: JSON.stringify({ model: MODEL_ID, messages: [{ role: user, content: prompt }], temperature: 0.7 }) }); if (!response.ok) { const errText await response.text(); throw new Error(模型请求失败: ${response.status} ${errText}); } const data await response.json(); return data.choices[0].message.content; }这里用的是 Node.js 18 内置的fetch不需要额外装 axios。注意BASE_URL后面拼的是/v1/chat/completions和前面说的路径规则一致。接着写路由src/routes/chat.jsimport { Router } from express; import { chatWithModel } from ../services/modelService.js; const router Router(); router.post(/chat, async (req, res) { const { prompt } req.body; if (!prompt) { return res.status(400).json({ error: prompt 不能为空 }); } try { const reply await chatWithModel(prompt); res.json({ framework: express, reply }); } catch (err) { res.status(500).json({ error: err.message }); } }); export default router;最后是入口src/server.js这里演示 Express 的中间件挂载方式import express from express; import chatRouter from ./routes/chat.js; const app express(); const PORT 3000; // 中间件解析 JSON 请求体 app.use(express.json()); // 中间件简单请求日志 app.use((req, res, next) { console.log([${new Date().toISOString()}] ${req.method} ${req.url}); next(); }); // 挂载路由 app.use(/api, chatRouter); app.listen(PORT, () { console.log(Express 服务已启动: http://localhost:${PORT}); });可以看到 Express 的中间件就是app.use()按顺序挂载路由用Router组织业务逻辑放在 service 里但框架本身不强制你这么做。启动用npm run dev。3.2 NestJS 项目初始化与模块、控制器、服务三层结构NestJS 用 CLI 初始化最省事。先全局装 CLI或者用 npxnpx nestjs/cli new nestjs-demo cd nestjs-demo npm install nestjs/config创建时选择 npm 作为包管理器。初始化完成后目录结构已经自带src/app.module.ts、src/app.controller.ts、src/app.service.ts。我们要新增一个 chat 模块。用 CLI 生成npx nest generate module chat npx nest generate controller chat npx nest generate service chat这会在src/chat/下生成三个文件。先配置环境变量在src/app.module.ts里引入ConfigModuleimport { Module } from nestjs/common; import { ConfigModule } from nestjs/config; import { AppController } from ./app.controller; import { AppService } from ./app.service; import { ChatModule } from ./chat/chat.module; Module({ imports: [ ConfigModule.forRoot({ isGlobal: true }), ChatModule ], controllers: [AppController], providers: [AppService] }) export class AppModule {}然后写src/chat/chat.service.ts这里体现依赖注入和业务逻辑封装import { Injectable, InternalServerErrorException } from nestjs/common; import { ConfigService } from nestjs/config; Injectable() export class ChatService { constructor(private configService: ConfigService) {} async chatWithModel(prompt: string): Promisestring { const baseUrl this.configService.getstring(TAOTOKEN_BASE_URL); const apiKey this.configService.getstring(TAOTOKEN_API_KEY); const modelId this.configService.getstring(TAOTOKEN_MODEL_ID); const response await fetch(${baseUrl}/v1/chat/completions, { method: POST, headers: { Content-Type: application/json, Authorization: Bearer ${apiKey} }, body: JSON.stringify({ model: modelId, messages: [{ role: user, content: prompt }], temperature: 0.7 }) }); if (!response.ok) { const errText await response.text(); throw new InternalServerErrorException(模型请求失败: ${response.status} ${errText}); } const data await response.json(); return data.choices[0].message.content; } }控制器src/chat/chat.controller.ts只负责接收请求和返回响应import { Body, Controller, Post } from nestjs/common; import { ChatService } from ./chat.service; Controller(api/chat) export class ChatController { constructor(private readonly chatService: ChatService) {} Post() async chat(Body(prompt) prompt: string) { if (!prompt) { return { error: prompt 不能为空 }; } const reply await this.chatService.chatWithModel(prompt); return { framework: nestjs, reply }; } }模块文件src/chat/chat.module.ts把三者组装起来import { Module } from nestjs/common; import { ChatController } from ./chat.controller; import { ChatService } from ./chat.service; Module({ controllers: [ChatController], providers: [ChatService] }) export class ChatModule {}最后改一下src/main.ts把端口设为 3001import { NestFactory } from nestjs/core; import { AppModule } from ./app.module; async function bootstrap() { const app await NestFactory.create(AppModule); await app.listen(3001); console.log(NestJS 服务已启动: http://localhost:3001); } bootstrap();启动用npm run start:dev。对比一下就能看出差异Express 里路由、中间件、业务逻辑的边界靠你自己划NestJS 里 Controller 只处理请求Service 封装业务Module 负责组装依赖注入让 Service 可以被替换和测试。这就是“架构驱动”和“工具库”的区别。4. 验证请求用 curl 分别打两个框架的接口并对照返回两个服务都启动后先确认端口Express 在 3000NestJS 在 3001。验证接口返回用 curl 最直接不需要打开 Postman。先打 Expresscurl -X POST http://localhost:3000/api/chat \ -H Content-Type: application/json \ -d {prompt:用一句话解释什么是依赖注入}预期返回类似{ framework: express, reply: 依赖注入是一种设计模式它把对象的依赖关系交给外部容器来创建和传递而不是在对象内部自己 new。 }再打 NestJScurl -X POST http://localhost:3001/api/chat \ -H Content-Type: application/json \ -d {prompt:用一句话解释什么是依赖注入}预期返回{ framework: nestjs, reply: 依赖注入是一种设计模式它把对象的依赖关系交给外部容器来创建和传递而不是在对象内部自己 new。 }两个返回的framework字段不同方便你确认请求打到了哪个服务reply内容来自同一个模型所以语义一致。如果你看到reply是空字符串或者报错先检查.env里的三件套是否正确尤其是 API Key 有没有多余空格。除了 curl你也可以用 REST Client 插件在 VS Code 里建一个.http文件把上面两段请求写进去点一下就能发。这种方式在反复调试时比复制 curl 命令更顺手。验证通过后你可以试着改一下 prompt比如让它返回 JSON 格式观察两个框架对返回内容的处理方式是否一致——实际上它们都只是把模型返回的字符串透传出去差异在框架层不在模型层。这里再补充一个对照点如果你在 Express 里想加一个统一的请求日志你写了一个app.use在 NestJS 里对应的概念是 Middleware 或 Interceptor。你可以试着在 NestJS 里加一个 Interceptor记录每个请求的耗时然后对比 Express 里用中间件实现同样功能的代码量。这个练习能让你直观感受到 NestJS 的“结构化扩展”和 Express 的“自由拼装”各自的手感。验证成功后建议把两个服务的启动命令分别记下来后面做选型对比时随时可以拉起来。如果你还想验证更多模型或对比不同 Model ID 的输出可以打开模型对话页面 https://taotoken.net/chat 快速试不用每次都改代码。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth 报错跑双框架 Demo 时报错基本集中在模型调用这一层因为框架本身的启动问题比较直观。下面按真实报错逐个排查。401 Unauthorized。这是最常见的返回体里通常有invalid api key或unauthorized。原因有三个Key 复制错了、Key 前后有空格、.env没被正确加载。先检查process.env.TAOTOKEN_API_KEY是否真的有值可以在服务启动时打印一下前几位不要打印完整 Key。Express 里确认import dotenv/config在文件顶部NestJS 里确认ConfigModule.forRoot({ isGlobal: true })已经引入。如果 Key 确认没问题检查请求头是不是Authorization: Bearer key少个空格也会 401。local proxy failed。这个报错通常出现在你本地网络环境有代理设置或者请求地址被解析到了错误的地方。先确认TAOTOKEN_BASE_URL是https://taotoken.net/api没有多余路径。然后检查你的终端或系统环境变量里有没有HTTP_PROXY、HTTPS_PROXY这类设置如果有临时取消掉再试。Node.js 的fetch会读取环境变量里的代理配置如果代理不可用就会报这个错。另外如果你在容器里跑确认容器能正常访问外网。Cannot read properties of undefined (reading choices)。这个报错说明data.choices是 undefined也就是返回体结构和你预期的不一样。常见原因是请求路径拼错了比如 Base URL 写成了https://taotoken.net/api/v1然后代码里又拼了/v1/chat/completions变成/api/v1/v1/chat/completions服务返回了错误信息而不是正常的 choices 结构。解决办法是打印完整的data看看实际返回了什么然后调整路径。正确的组合是 Base URLhttps://taotoken.net/api 代码里拼/v1/chat/completions。OAuth 相关报错。如果你用的是某些 CLI 工具或 SDK可能会遇到 OAuth 认证失败。这类工具通常有自己的登录流程和 API Key 是两套体系。如果你只是想用 API Key 调用确认工具配置里选择的是 API Key 模式而不是 OAuth 模式。对于 Claude Code 这类工具接入文档在 https://taotoken.net/doc 里面有具体的配置说明。如果你在 NestJS 里用了某个 SDK 报 OAuth 错先换成直接用fetch发请求排除 SDK 配置问题。端口占用。Express 默认 3000NestJS 默认 3000如果你先启动了 Express 再启动 NestJSNestJS 会报EADDRINUSE。解决办法是在main.ts里把 NestJS 端口改成 3001或者启动前先确认端口空闲。这个错和模型调用无关但很容易在双项目并行时遇到。模型 ID 不存在。返回体里会有model not found之类的提示。检查TAOTOKEN_MODEL_ID是否拼写正确注意大小写和连字符。你可以在控制台 https://taotoken.net/console 查看可用模型列表或者直接在模型对话页面试一下这个 Model ID 能不能用。排查顺序建议先看 HTTP 状态码401 查 Key404 查路径500 查模型返回体。把完整错误信息打印出来比猜要快得多。如果你在 NestJS 里看到异常被包装成了InternalServerErrorException可以在ChatService里先把原始错误console.error出来再抛出去这样排查更方便。6. 继续深入把双框架 Demo 扩展成可对比的选型基线跑通上面的 Demo 之后你手里就有了一条可对比的基线同样的模型调用Express 用路由 中间件 service 组织NestJS 用模块 控制器 服务 依赖注入组织。接下来你可以在这条基线上加东西观察两个框架的扩展成本。比如加一个统一的鉴权Express 里写一个中间件检查请求头里的 tokenNestJS 里写一个 Guard两者代码量差不多但 NestJS 的 Guard 可以被更细粒度地绑定到控制器或方法上。再加一个参数校验Express 里你可能用 zod 或 joi 手动校验NestJS 里用 ValidationPipe 配合 DTO 类声明式更强。如果你打算长期做编码类任务或者要把这套 Demo 扩展成 Agent 服务可以看看 Coding Plan https://taotoken.net/coding-plan 它在持续调用场景下更合适。需要新的 API Key 时直接去 https://taotoken.net/api-keys 创建想快速验证模型输出用 https://taotoken.net/chat 完整的接入文档在 https://taotoken.net/doc 。把这两个项目留在你的工作目录里下次做技术选型时直接拉起来改一改比重新搭环境快得多。 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
