| name | backend-test-writer |
| description | 为后端代码（Express 路由、MongoDB 模型、Node 服务）生成测试时使用 - 分析文件类型，从 package.json 检测测试框架，生成包含设置/拆卸和边缘情况覆盖的全面测试 |
后端测试编写器
为 MERN 技术栈代码生成全面的后端测试。分析文件类型，检测项目约定，生成可直接运行的测试。
理念： 智能默认值，零配置。从项目中自动检测一切。
工作流程
复制并跟踪进度：
阶段 0：基础设施检查
生成测试前，验证环境：
- 检查
package.json 中的测试框架（Jest/Vitest/Mocha）
- 如果没有 → 提示："是否设置 Jest + Supertest？"
- 检查
mongodb-memory-server（集成测试需要）
- 检测测试文件约定（同目录、
__tests__/ 或 tests/）
停止条件： 无测试框架且用户拒绝设置。
阶段 1：分析目标文件
| 模式 | 类型 | 测试方法 |
|---|
routes/、*.routes.js | 路由 | 集成测试（Supertest + 真实数据库） |
controllers/ | 控制器 | 集成测试 |
services/ | 服务 | 单元测试（mock 依赖） |
models/、*.model.js | 模型 | 单元测试（验证测试） |
middleware/ | 中间件 | 单元测试（mock req/res/next） |
utils/、helpers/ | 工具 | 单元测试（纯函数） |
覆盖： 用户可指定 --unit 或 --integration。
阶段 2：生成测试
按顺序处理文件并显示进度。用户可随时停止。
每个测试包含：
- 检测到的框架对应的正确导入
- 设置/拆卸（数据库连接、清理）
- 全面覆盖：
- 成功场景（正常路径）
- 验证错误（400）
- 未找到（404）
- 认证失败（401/403）（如果受保护）
- 边缘情况（重复、空值、null）
参考： 完整代码示例请参阅 test-patterns.md。
阶段 3：报告
已生成：X 个测试文件
覆盖：共 Y 个测试用例
下一步：运行 `npm test` 验证
快速参考
| 文件类型 | 导入 | 数据库设置 |
|---|
| 路由 | supertest、mongodb-memory-server | 真实（内存数据库） |
| 服务 | jest | Mock |
| 模型 | mongoose | Mock |
| 中间件 | jest | 无 |
测试结构模式
describe('[资源] [方法]', () => {
describe('success cases', () => {
it('should [expected behavior]', async () => {});
});
describe('validation errors', () => {
it('should return 400 for [invalid case]', async () => {});
});
describe('edge cases', () => {
it('should handle [edge case]', async () => {});
});
});
检查清单
基础设施（优先检查）
每个文件的生成检查
常见错误
| 错误 | 修复 |
|---|
| 在测试中启动服务器 | 导入 app，让 Supertest 处理 |
| 无数据库清理 | 添加 afterEach 和 deleteMany({}) |
| 测试实现细节 | 通过 HTTP 接口测试行为 |
| 缺少 async/await | 等待异步操作 |
| 在集成测试中使用 mock | 集成测试使用真实数据库 |
准则
- 不要为未阅读的代码生成测试
- 不要跳过基础设施检查
- 不要只生成正常路径测试
- 不要忘记测试间的清理
参考文件
实现特定模式时加载：
