lijiaoqiao/supply-api/docs/integration_tests.md

Supply API 集成测试指南

概述

本项目包含单元测试和集成测试。集成测试需要真实的基础设施（PostgreSQL 和 Redis）。

测试类型

类型	运行方式	基础设施
单元测试	go test ./...	Mock
集成测试	go test -tags=integration ./...	真实 DB + Redis

快速开始

1. 启动测试基础设施

docker-compose -f deploy/docker-compose.yml up -d

2. 运行集成测试

# 使用提供的脚本（推荐）
./scripts/run_integration_tests.sh

# 或手动运行
export SUPPLY_API_DB_HOST="localhost"
export SUPPLY_API_DB_PORT="5432"
export SUPPLY_API_DB_USER="supply_test"
export SUPPLY_API_DB_PASSWORD="supply_test_pass"
export SUPPLY_API_DB_NAME="supply_test"
export SUPPLY_TEST_POSTGRES="postgres://supply_test:supply_test_pass@localhost:5432/supply_test?sslmode=disable"
export SUPPLY_TEST_REDIS="localhost:6379"
go test -tags=integration -v ./internal/repository ./internal/middleware/...

3. 停止基础设施

docker-compose -f deploy/docker-compose.yml down -v

测试覆盖

当前覆盖率

模块	单元测试覆盖率	集成测试覆盖
middleware	80.4%	完整覆盖
- db_token_backend.go	92%+	真实 DB + Redis
- token_revocation_service.go	71%+	Redis Pub/Sub

集成测试覆盖的场景

1. CheckTokenStatus_CacheHit - Redis 缓存命中
2. RevokeToken - 真实数据库和 Redis 联动
3. RevokeBySubjectID - 批量吊销
4. RevocationService - Redis Pub/Sub 发布/订阅

文件结构

supply-api/
├── deploy/
│   └── docker-compose.yml          # 测试基础设施
├── scripts/
│   └── run_integration_tests.sh    # 集成测试运行脚本
├── internal/
│   └── middleware/
│       ├── db_token_backend_integration_test.go  # 集成测试
│       └── *_test.go               # 单元测试
└── docs/
    └── integration_tests.md        # 本文档

常见问题

Q: 集成测试需要什么？

A: Docker 和 Docker Compose。需要 PostgreSQL 15+ 和 Redis 7+。

Q: 可以在 CI 中运行集成测试吗？

A: 可以。CI 环境需要：

1. Docker-in-Docker (DinD) 支持
2. 使用 docker-compose up -d 启动基础设施
3. 为 repository 测试设置 SUPPLY_API_DB_* 环境变量
4. 为 middleware 测试设置 SUPPLY_TEST_POSTGRES 和 SUPPLY_TEST_REDIS
5. 运行 go test -tags=integration ./...

Q: 为什么某些测试需要集成测试？

A: 某些代码路径依赖真实的基础设施：

• Redis Pub/Sub 发布/订阅功能
• PostgreSQL 事务和约束
• 网络超时和重试逻辑
• 连接池行为

单元测试使用 mock 无法完全模拟这些行为。

清理

# 停止并清理容器和数据卷
docker-compose -f deploy/docker-compose.yml down -v