ai-talk-callback/TEST_README.md

AI Talk Callback 接口测试说明

概述

本项目为 AI Talk 回调接口编写了完整的测试用例，覆盖了各种场景和边界条件。

测试文件

• test_callback.py - 主要测试文件，包含所有接口测试用例
• conftest.py - pytest配置文件，包含测试fixtures
• run_tests.py - 测试运行脚本

测试覆盖的场景

1. 基础功能测试

• ✅ 根接口测试 (GET /)
• ✅ 健康检查接口测试 (GET /health)

2. 回调接口测试 (POST /ai-talk/callback/{siteId}/failure)

2.1 正常业务流程

• ✅ count < 3 且外部API调用成功
• ✅ count >= 3 直接返回（不调用外部API）
• ✅ 空数据列表处理

2.2 异常情况处理

• ✅ 外部API调用失败
• ✅ 数据库连接错误
• ✅ Redis锁获取失败
• ✅ 服务器内部错误

2.3 数据验证

• ✅ 无效请求数据（缺少必需字段）
• ✅ 负数count值验证

运行测试

方法1: 使用pytest直接运行

# 安装测试依赖
pip install -r requirements.txt

# 运行所有测试
pytest test_callback.py -v

# 运行特定测试
pytest test_callback.py::TestAITalkCallback::test_callback_count_below_threshold_success -v

# 运行并显示覆盖率
pytest test_callback.py -v --cov=app --cov-report=html

方法2: 使用运行脚本

# 运行所有测试
python run_tests.py

# 运行特定测试
python run_tests.py test_callback_count_below_threshold_success

测试数据

测试使用了模拟的回调数据，包含完整的字段结构：

{
    "count": 2,
    "data": [
        {
            "bill": 100,
            "duration": 60,
            "callid": "test-call-123",
            "calldate": "2024-01-01 12:00:00",
            "number": "13800138000",
            "numberid": "number-123",
            "customer_id": "customer-123",
            "status": 0,
            "status_str": "失败",
            "user_id": "user-123",
            "type": 1,
            "number_data": {
                "number": "13800138000",
                "province": "广东",
                "city": "深圳",
                "operator": "移动"
            },
            "group": {
                "id": 1,
                "name": "测试组"
            },
            "task": {
                "id": "task-123",
                "name": "测试任务"
            },
            "user": {
                "id": "user-123",
                "name": "测试用户"
            },
            "customer_data": {
                "name": "测试客户",
                "email": "test@example.com",
                "company": "测试公司",
                "extra": "额外信息"
            }
        }
    ]
}

Mock策略

测试中使用了以下Mock策略：

1. 数据库Mock: 使用 AsyncMock 模拟数据库会话
2. Redis Mock: 模拟Redis分布式锁操作
3. 外部API Mock: 模拟外部API调用和重试机制
4. 日志记录Mock: 模拟数据库日志记录功能

测试环境配置

测试使用SQLite内存数据库，避免影响生产数据：

TEST_DATABASE_URL = "sqlite+aiosqlite:///./test.db"

预期测试结果

成功运行时应该看到类似输出：

============================= test session starts =============================
collected 10 items

test_callback.py::TestAITalkCallback::test_root_endpoint PASSED         [ 10%]
test_callback.py::TestAITalkCallback::test_health_check PASSED          [ 20%]
test_callback.py::TestAITalkCallback::test_callback_count_below_threshold_success PASSED [ 30%]
test_callback.py::TestAITalkCallback::test_callback_count_above_threshold_direct_return PASSED [ 40%]
test_callback.py::TestAITalkCallback::test_callback_external_api_failure PASSED [ 50%]
test_callback.py::TestAITalkCallback::test_callback_invalid_request_data PASSED [ 60%]
test_callback.py::TestAITalkCallback::test_callback_invalid_count_negative PASSED [ 70%]
test_callback.py::TestAITalkCallback::test_callback_empty_data_list PASSED [ 80%]
test_callback.py::TestAITalkCallback::test_callback_database_error PASSED [ 90%]
test_callback.py::TestAITalkCallback::test_callback_redis_lock_error PASSED [100%]

============================== 10 passed in 2.34s ==============================
✅ 所有测试通过!

注意事项

1. 确保安装了所有测试依赖
2. 测试运行时会创建临时SQLite数据库文件
3. 测试使用了Mock，不会实际调用外部API
4. 建议在CI/CD环境中集成这些测试