NestJS后端E2E测试最佳实践与测试覆盖范围咨询

问题背景 #

我编写了一段针对NestJS中/auth/模块的E2E测试代码如下：

import { Test, TestingModule } from '@nestjs/testing'
import { INestApplication, ValidationPipe } from '@nestjs/common'
import request from 'supertest'
import { AppModule } from '../src/app.module'
import {DataSource} from "typeorm";

describe('Auth (e2e)', () => {
    let app: INestApplication
    let dataSource: DataSource
    const testEmail = `test_${Date.now()}@test.com`
    const testPassword = 'TestPassword123'

    beforeAll(async () => {
        const moduleFixture: TestingModule = await Test.createTestingModule({
            imports: [AppModule],
        }).compile()

        app = moduleFixture.createNestApplication()
        app.useGlobalPipes(new ValidationPipe())
        await app.init()

        dataSource = app.get(DataSource)
    })

    afterAll(async () => {
        await dataSource.query(`DELETE FROM "user" WHERE email LIKE 'test_%'`)
        await app.close()
    })

    it('POST /auth/register - should register new user', () => {
        return request(app.getHttpServer())
            .post('/auth/register')
            .send({ email: testEmail, password: testPassword })
            .expect(201)
            .expect(res => {
                expect(res.body.email).toBe(testEmail)
                expect(res.body.id).toBeDefined()
                expect(res.body.password).toBeUndefined()
            })
    })

    it('POST /auth/register - fail if email is not email', () => {
        return request(app.getHttpServer())
            .post('/auth/register')
            .send({ email: "notemail", password: testPassword })
            .expect(400)
            .expect(res => {
                expect(res.body.message).toStrictEqual(["email must be an email"])
                expect(res.body.error).toBe("Bad Request")
                expect(res.body.statusCode).toBe(400)
            })
    })

    it('POST /auth/login - should login new user', () => {
        return request(app.getHttpServer())
            .post('/auth/login')
            .send({ email: testEmail, password: testPassword })
            .expect(201)
            .expect(res => {
                expect(res.body.success).toBe(true)
            })
    })

    it('POST /auth/register - should fail if email already exists', () => {
        return request(app.getHttpServer())
            .post('/auth/register')
            .send({ email: testEmail, password: testPassword })
            .expect(400)
            .expect(res => {
                expect(res.body.message).toBe("Email already exists")
                expect(res.body.error).toBe("Bad Request")
                expect(res.body.statusCode).toBe(400)
            })
    })
})

想咨询：

• 当前编写的这些测试（邮箱格式无效时注册失败、新用户登录成功、邮箱已存在时注册失败等）是否合理？
• 是否需要为后端所有可能的返回编写E2E测试？
• 若您有包含E2E测试和单元测试的仓库，恳请分享。

解答 #

1. 当前测试的合理性 #

你的测试非常合理，精准覆盖了Auth模块最核心的业务场景：

• 正常注册流程：验证用户能成功创建，且返回数据符合安全预期（不暴露密码字段）
• 输入校验异常：测试邮箱格式不符合规则时的错误返回逻辑
• 业务逻辑冲突：测试重复邮箱注册的拦截机制
• 正常登录流程：验证注册后的用户能完成登录

这些都是Auth模块的关键路径，能有效保障核心功能的正确性。如果你的后端还有额外校验规则（比如密码复杂度要求），可以补充对应测试用例，比如测试密码长度不足、缺少大小写字母时的注册失败场景。

2. 是否需要为所有可能的返回编写E2E测试 #

不需要覆盖所有可能的返回。E2E测试的核心是验证端到端的业务协作流程，重点放在核心成功路径、高频异常场景上；而细粒度的边界情况（比如密码包含特殊字符的校验、邮箱带特殊后缀的合法性等）应该交给单元测试来覆盖。

举个分工示例：

• E2E测试：聚焦「合法输入成功注册」「重复邮箱注册失败」这类完整流程
• 单元测试：针对AuthService里的单个方法（比如validateEmailFormat），覆盖各种边界输入场景（比如带下划线的邮箱、顶级域名过短的邮箱等）

这样既能保证核心流程的可靠性，又不会让E2E测试变得臃肿、执行缓慢。

3. 测试仓库示例参考 #

你可以参考NestJS官方提供的示例项目，里面有完整的单元测试和E2E测试实现：

• 单元测试：通常放在对应模块目录下，命名为*.spec.ts（比如auth.service.spec.ts），会Mock数据库、第三方服务等依赖，专注测试单个服务的逻辑正确性
• E2E测试：放在test目录下，命名为*.e2e-spec.ts（比如auth.e2e-spec.ts），用supertest调用真实接口，测试完整请求流程，同时会在测试前后清理测试数据（和你当前的实现思路一致）

官方示例的核心思路是：单元测试保证单个组件逻辑正确，E2E测试保证组件之间的协作流程符合预期。

内容的提问来源于stack exchange，提问作者Roderen