从 NestJS 基础到 LangChain 实战：建立可维护的 AI 应用架构

至于写在前面，你可能遇到的痛点

如果你正在学习 NestJS + LangChain很可能会遇到以下几个痛点：

• 概念模糊不清Controller、Service、Module 的关系不明；管道与拦截器到底有什么区别？
• 项目结构混乱手动创建文件夹和文件，容易导致代码难以维护。
• AI 集成困难不了解如何把大语言模型与后端业务逻辑无缝衔接。
• 性能与安全顾虑没有统一的请求验证、限流和错误处理机制。

本教程旨在一次性解决这些痛点，帮你从基础开始搭建一个结构清晰、易维护且使用较稳定的 AI 应用。

一、为什么是 NestJS？它和 Express 有什么不同？

开始写代码之前。先搞清楚一个根本问题：为什么业界选择 NestJS，而不是直接用 Express？

中间件 ：最早接触请求，用于日志记录等全局设置。

``ts // src/common/middleware/logger.middleware.ts export function loggerMiddleware{ console.log.toISOString}] ${req.method} ${req.url});console.log，next;// 必须调用放行，}

// 在模块中注册: @Module export class AppModule{ configure{ consumer.apply.forRoutes;// 对所有路由生效，也可指定特定方法. } }

守卫 ：权限或身份校验。老实说，

ts// src/common/guards/api-key.guard.ts import{ Injectable。CanActivate,ExecutionContext,UnauthorizedException}from '@nestjs/common';@Injectable export class ApiKeyGuard implements CanActivate{ canActivate:boolean{ const request=context.switchToHttp.getRequest;const apiKey=request.headers;if{return true;} throw new UnauthorizedException;}}// 在控制台中使用@Post@UseGuards async askQuestion dto:any){return this.ai.ask;}

拦截器 ：统一响应格式化或缓存等后置处理。

ts// src/common/interceptors/transform.interceptor.ts import{ Injectable。NestInterceptor，ExecutionContext，CallHandler}from '@nestjs/common';import{ Observable }from 'rxjs';import{ map }from 'rxjs/operators';说起来，@Injectable export class TransformInterceptor implements NestInterceptor{ intercept:Observable{ console.log;return next.handle.pipe.toISOString,data})) );}} app.useGlobalInterceptors);

四者对比表的观点是，

七 MVC 架构落地 – 层级拆解

虽然 Nest 并非传统 MVC，但其分层思想完美继承。传统 MVC 中 Model 在 Nest 被拆解为三部分:

八 模块之间关系 – 多功能聚合不是 “单一 controller/service”

• 一个 Module 可以包含多个 Controller 与 Provider。*
• 一个 Controller 可注入多 Service。*
• 一个 Module 可仅提供工具类而无 Controller。*

举例这方面。ts // ✅ 多 controller 同 module: @Module export class MultiCtrlMod{} ... // ✅ Controller 注入多 Service: @Controller export class OrderCtrl{ constructor{} } // ✅ 无 controller 的纯工具 Module: @Module export Class CacheMod{} 🛠️ 实战建议 ：按功能领域 Domain 划分 Module，而非死板追求“一对一”。

九 与 LangChain 集成 — 把 AI 真正嵌进架构中！

安装依赖的观点是，

bash npm install nestjs-langchain langchain @langchain/openai

注册 LangChain 模块：

ts// src/app.module.ts import{ Module }from '@nestjs/common';import{ LangChainModule}from 'nestjs-langchain';import{ AiModule}from './ai/ai.module'; 不过，@Module({ imports:。}) export class AppModule{}

在 Service 使用 LangChain 调用：

ts//src/ai/ai.service.ts import{ Injectable}from '@nestjs/common';import{ LangChainService}from 'nestjs-langchain';@Injectable export class AiService{ constructor{} async askQuestion{return await this.lcSvc.run;} async askWithCtx{const prompt=`基于以下上下文回答问题: 上下文这方面。${c} 再看问题，${q}`;return awaitthis.lcSvc.run;} }

将 Service 方法变成 AI Tool — 最功能比较丰富！

通过 @Tool 装饰任何 Service 方法都可被 LLM 调用：

ts//src/math/math.service.ts import { Injectable } from "@nestjs/common";import { Tool,ToolParam} from "nestjs-langchain";@Injectable export defaultclass MathServ{ /** 用来实现加法计算 */ @Tool add( @)a这方面。number,@) b:number ): number{return a+b;} /** 获取天气信息 */ @Tool async getWear( @) city:string ): Promise{ return `${city}天气晴天`;} } 从注册工具来看，ts//src/app.module....@ module:{ imports: /* 注册 MathServ 所有方法 */,})。MathServ] } ... 现在当使用者提问 “帮我算一下 7 + 8 等于多少”，AI 会自动识别并调用 MathServ.add。

十 给 AI 应用实战建议——常用方法汇总！

1️⃣ 守卫保护接口 ts@Post@UseGuards async ask dto:any ){returnthis.ai.ask;}

2️⃣ 管道验证输入 tsclass AskDto{ @)@)@) question:string;@)@)@) temperature?:number，}

3️⃣ 拦截统一响应格式 json{"code":200。"success":true,"timestamp":"2026‑08‑14T10…","data":{"answer":"..."。"tokensUsed":34}}

4️⃣ 分层职责清晰 * Controller – 路由 + 参数校验；* Service – Prompt 构造 + LangChain 调取 + Result 整理；按理说，* Repository – 对话历史及使用者数据持久化。

5️⃣ 日志与监控 * 用中间件记录访问日志；* 用守卫做限流，* 用拦截插件统计耗时与错误率。

6️⃣ 安全防护 * 所有外部 API 调起都要鉴权；* 输入校验防止恶意调用导致 Token 泄露；按理说，* 对敏感数据做加密存储。

7️⃣ 性能调整 * 对高频问答结果做缓存；* 利用向量数据库做 RAG；* 如需流式输出，可改为 SSE/WebSocket。话说回来，

8️⃣ 持续集成 CI/CD * 单元测试覆盖关键业务；* 自动部署至容器化环境，如 Docker/K8S。

9️⃣ 团队协作规范 * 坚持命名约定；* 每个 Domain 有独立 module；* 所有新功能先通过 CLI skeleton 再实现。

10️⃣ 🚀 打开 Next 👉 学习更深层次 LangChain 概念—— Chain / Agent / Retriever / Vector Store；实现 RAG 场景，支持流式响应等高级特性。

接下来学习方向🔭

• \*\*深入 LangChain\*\*: 理解 Chain 、Agent 、Retriever 、Vector Store 等概念。
• \*\*RAG 实战\*\*: 与向量数据库如 Chroma/Pinecone 搭配，实现知识库问答。
• \*\*流式响应\*\*: 使用 SSE 或 WebSocket 实现实时输出。
• \*\*单元测试\*\*: 用 Jest/Nest Testing 工具覆盖 Service 与 Controller。