2025-07-02 22:37:06 +08:00

7.1 KiB

Raw Blame History

Controller Tests

这个目录包含了NestJS应用程序中所有controller的完整测试用例。每个controller都有独立的测试文件，覆盖了所有的API接口和各种测试场景。

📁 测试文件结构

test/controllers/
├── README.md                           # 本文件
├── category.controller.test.ts         # 分类查询API测试
├── tag.controller.test.ts              # 标签查询API测试
├── post.controller.test.ts             # 文章操作API测试
├── comment.controller.test.ts          # 评论操作API测试
├── user.controller.test.ts             # 用户查询API测试
├── account.controller.test.ts          # 账户操作API测试
├── role.controller.test.ts             # 角色查询API测试
└── manager/                            # 管理后台API测试
    ├── category.controller.test.ts     # 分类管理API测试
    ├── tag.controller.test.ts          # 标签管理API测试
    ├── post.controller.test.ts         # 文章管理API测试
    ├── comment.controller.test.ts      # 评论管理API测试
    ├── user.controller.test.ts         # 用户管理API测试
    ├── role.controller.test.ts         # 角色管理API测试
    └── permission.controller.test.ts   # 权限管理API测试

🧪 测试覆盖范围

每个测试文件都包含以下类型的测试用例：

✅ 成功场景测试

正常的API调用和响应
有效的参数和数据
正确的权限验证

❌ 失败场景测试

参数验证失败
权限验证失败
数据不存在
业务逻辑错误

🔍 边界值测试

最大/最小值测试
空值和null值测试
特殊字符测试
长度限制测试

🔐 权限测试

未认证访问
权限不足
Token验证

🚀 运行测试

运行所有controller测试

npm run test:controllers

运行特定的测试文件

# 运行分类controller测试
npm run test:controllers category

# 运行用户相关测试
npm run test:controllers user account

# 运行管理后台测试
npm run test:controllers manager

运行测试组

# 运行所有前台API测试
npm run test:controllers app

# 运行所有管理后台API测试
npm run test:controllers manager

# 运行所有内容相关测试
npm run test:controllers content

# 运行所有用户认证相关测试
npm run test:controllers user-auth

# 运行所有权限相关测试
npm run test:controllers rbac

使用Jest直接运行

# 运行单个测试文件
npx jest test/controllers/category.controller.test.ts

# 运行所有controller测试
npx jest test/controllers/

# 运行测试并生成覆盖率报告
npx jest test/controllers/ --coverage

# 运行测试并监听文件变化
npx jest test/controllers/ --watch

📊 测试报告

测试运行后会生成以下报告：

控制台输出

测试执行摘要
失败测试详情
性能统计
覆盖率摘要

HTML报告

位置：coverage/controllers/test-report.html
包含详细的测试结果和覆盖率信息

JSON报告

位置：coverage/controllers/test-results.json
机器可读的测试结果数据

覆盖率报告

位置：coverage/controllers/lcov-report/index.html
详细的代码覆盖率分析

🛠️ 测试配置

Jest配置

测试使用专门的Jest配置文件：test/jest.controller.config.js

环境变量

测试运行时会使用以下环境变量：

NODE_ENV=test
APP_PORT=3001
TEST_DB_HOST=localhost
TEST_DB_PORT=3306
TEST_DB_DATABASE=nestapp_test
TEST_DB_USERNAME=root
TEST_DB_PASSWORD=

测试数据库

测试使用独立的测试数据库
每个测试都会创建和清理自己的测试数据
不会影响开发或生产数据

📝 编写新的测试

测试文件模板

import { NestFastifyApplication } from '@nestjs/platform-fastify';
import { DataSource } from 'typeorm';
import { createApp } from '@/modules/core/helpers/app';
import { App } from '@/modules/core/types';
import { createOptions } from '@/options';

const URL_PREFIX = '/api/v1/your-module';

describe('YourController', () => {
    let datasource: DataSource;
    let app: NestFastifyApplication;
    let testData: any[];

    beforeAll(async () => {
        const appConfig: App = await createApp(createOptions)();
        app = appConfig.container;
        await app.init();
        await app.getHttpAdapter().getInstance().ready();

        datasource = app.get<DataSource>(DataSource);
        
        if (!datasource.isInitialized) {
            await datasource.initialize();
        }

        await setupTestData();
    });

    afterAll(async () => {
        await cleanupTestData();
        await datasource.destroy();
        await app.close();
    });

    async function setupTestData() {
        // 创建测试数据
    }

    async function cleanupTestData() {
        // 清理测试数据
    }

    describe('GET /endpoint', () => {
        it('should return success response', async () => {
            const result = await app.inject({
                method: 'GET',
                url: `${URL_PREFIX}/endpoint`,
            });

            expect(result.statusCode).toBe(200);
            // 添加更多断言
        });
    });
});

测试数据生成

使用 test/helpers/test-data-generator.ts 中的工具函数：

import { 
    generateTestUser, 
    generateTestCategory,
    TestDataManager 
} from '../helpers/test-data-generator';

const dataManager = new TestDataManager();

// 生成测试用户
const testUser = generateTestUser('mytest');

// 生成测试分类
const testCategory = generateTestCategory('MyTestCategory');

// 添加清理任务
dataManager.getCleaner().addCleanupTask(async () => {
    await userRepository.remove(testUser);
});

🔧 故障排除

常见问题

数据库连接失败
- 检查测试数据库是否存在
- 确认数据库连接配置正确
测试超时
- 增加Jest超时时间
- 检查是否有未关闭的数据库连接
权限测试失败
- 确认测试用户有正确的权限
- 检查认证token是否有效
测试数据冲突
- 确保每个测试使用独立的测试数据
- 检查测试数据清理是否完整

调试技巧

启用详细日志

DISABLE_TEST_LOGS=false npm run test:controllers

运行单个测试

npx jest test/controllers/category.controller.test.ts --verbose

使用调试器

node --inspect-brk node_modules/.bin/jest test/controllers/category.controller.test.ts --runInBand

📚 相关文档

🤝 贡献指南

为新的controller添加对应的测试文件
确保测试覆盖所有的API接口
包含成功和失败场景的测试用例
使用独立的测试数据，避免测试间的相互影响
添加适当的注释和文档

7.1 KiB Raw Blame History Unescape Escape