1. 课程导学与整体架构
本课程围绕“Go Web 服务契约压测闭环”这一核心工程实践展开，旨在帮助后端开发者构建一套从接口契约定义、自动化压测脚本生成、到性能瓶颈分析与持续回归的完整工作流。NestJS 项目在本课程中扮演“被压测的目标服务”与“契约验证的参考实现”双重角色。
1.1 什么是“Go Web 服务契约压测闭环”？
传统压测往往存在三个断裂：压测脚本与接口文档脱节、压测结果与代码变更失联、Go 服务与前端/微服务间的契约无人守护。本课程提出的闭环模型将压测嵌入到契约驱动的开发流程中，形成可重复、可追溯、可自动化的质量保障环。
核心闭环流程：
接口契约定义 → 自动生成压测脚本 → 执行压测并采集指标 → 分析瓶颈并优化代码 → 回归验证契约一致性 → 更新契约基线。
接口契约定义 → 自动生成压测脚本 → 执行压测并采集指标 → 分析瓶颈并优化代码 → 回归验证契约一致性 → 更新契约基线。
1.2 NestJS 项目在闭环中的角色
NestJS 是一个基于 TypeScript、受 Angular 架构启发的 Node.js 服务端框架。在本课程中，NestJS 项目承担以下三个关键职责：
| 角色 | 具体职责 | 与 Go 服务的交互方式 |
|---|---|---|
| 被压测目标 | 部署为 HTTP/REST 服务，接收 Go 压测引擎发起的并发请求 | Go 压测工具（如 k6、vegeta）直接调用 NestJS 暴露的 API |
| 契约参考实现 | 基于 OpenAPI 规范实现接口，作为契约一致性的验证基准 | Go 契约校验工具对比 NestJS 响应与契约定义的差异 |
| 性能基线提供者 | 在 CI/CD 中定期压测，输出响应时间、吞吐量、错误率等基线数据 | Go 分析脚本读取 NestJS 的 Prometheus 指标或日志 |
为什么选择 NestJS？ 其模块化架构、依赖注入、以及内置的 OpenAPI 集成（通过 @nestjs/swagger）使得契约生成和维护变得非常自然，非常适合作为压测闭环中的“契约锚点”。
1.3 课程目标
完成本课程后，你将能够：
- 掌握契约驱动压测的方法论：理解从接口定义到压测脚本自动映射的完整链路。
- 独立部署 NestJS 项目：使用 Docker Compose 和 Nginx 在生产风格环境中运行 NestJS 服务。
- 编写 Go 压测脚本：使用 k6（Go 生态兼容）或 Go 原生压测库，对 NestJS 接口执行并发压测。
- 分析压测结果并优化：通过响应时间分布、错误率、CPU/内存指标定位瓶颈。
- 建立持续压测流水线：将压测集成到 GitHub Actions 中，每次代码变更自动触发契约验证和性能回归。
1.4 学习路径与章节地图
课程共分为 6 个阶段，30 个章节，按以下路径递进：
1.5 前置知识与技术栈
本课程假设你具备以下基础：
- 熟悉 Go 语言基础语法和 HTTP 编程
- 了解 Node.js / TypeScript 基本概念
- 掌握 Docker 和 Docker Compose 的基本使用
- 对 RESTful API 设计有初步认识
课程中涉及的核心技术栈如下：
| 技术 | 版本 | 用途 |
|---|---|---|
| Go | 1.21+ | 压测引擎、契约校验工具、分析脚本 |
| NestJS | 10.x | 目标服务实现、契约参考实现 |
| k6 | 0.48+ | Go 生态兼容的压测工具 |
| OpenAPI 3.0 | 3.0.3 | 接口契约定义格式 |
| Docker Compose | 2.x | NestJS 服务部署 |
| Prometheus + Grafana | 最新稳定版 | 性能指标采集与可视化 |
注意： 本课程不深入讲解 Go 或 NestJS 的基础语法。如果你对上述技术栈完全陌生，建议先完成官方快速入门教程再开始本课程。
1.6 课程产出物概览
完成全部章节后，你将获得以下可直接复用的工程资产：
- NestJS 项目模板：包含 OpenAPI 集成、健康检查、Prometheus 指标暴露的完整项目。
- Go 压测脚本库：针对常见 API 模式（CRUD、分页、鉴权）的可复用压测脚本。
- Docker Compose 部署配置：NestJS + Nginx + Prometheus + Grafana 的一键部署方案。
- GitHub Actions 工作流：自动契约校验 + 压测执行 + 结果对比的 CI 流水线。
- 性能分析报告模板：包含响应时间分布、吞吐量趋势、瓶颈定位的结构化报告。