146 lines
3.5 KiB
Markdown
146 lines
3.5 KiB
Markdown
|
# 前后端测试分析报告
|
||
|
|
|
||
|
|
**Date:** 2026-03-04
|
||
|
|
**Status:** Completed
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 测试统计
|
||
|
|
|
||
|
|
### 后端测试
|
||
|
|
|
||
|
|
| 类型 | 数量 | 状态 |
|
||
|
|
|------|------|------|
|
||
|
|
| Unit Tests | ~100+ | 可运行 |
|
||
|
|
| Integration Tests | ~70+ | 可运行 |
|
||
|
|
| E2E Tests | 5 | **无法运行** (缺少 playwright 依赖) |
|
||
|
|
|
||
|
|
### 前端测试
|
||
|
|
|
||
|
|
| 类型 | 数量 | 状态 |
|
||
|
|
|------|------|------|
|
||
|
|
| Flutter Tests | 140 | ✅ 全部通过 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 问题发现
|
||
|
|
|
||
|
|
### 1. 后端 E2E 测试无法运行 (HIGH)
|
||
|
|
|
||
|
|
**问题**: 5 个 E2E 测试文件需要 `playwright` 模块，但依赖未安装。
|
||
|
|
|
||
|
|
**影响文件**:
|
||
|
|
- `tests/e2e/test_auth_flow.py`
|
||
|
|
- `tests/e2e/test_infra_health_e2e.py`
|
||
|
|
- `tests/e2e/test_logging_e2e.py`
|
||
|
|
- `tests/e2e/test_mobile_health_e2e.py`
|
||
|
|
- `tests/e2e/test_profile_flow.py`
|
||
|
|
|
||
|
|
**错误**:
|
||
|
|
```
|
||
|
|
ModuleNotFoundError: No module named 'playwright'
|
||
|
|
```
|
||
|
|
|
||
|
|
**建议**:
|
||
|
|
- 安装 playwright: `uv add playwright && uv run playwright install`
|
||
|
|
- 或者移除这些无法运行的 E2E 测试文件
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
### 2. 测试文件命名冲突导致收集警告 (LOW)
|
||
|
|
|
||
|
|
**问题**: 存在多个同名 `test_schemas.py` 文件在不同目录，导致 pytest 收集时显示警告。
|
||
|
|
|
||
|
|
**影响文件**:
|
||
|
|
- `tests/unit/v1/schedule_items/test_schemas.py`
|
||
|
|
- `tests/unit/v1/profile/test_schemas.py`
|
||
|
|
- `tests/unit/v1/inbox_messages/test_schemas.py`
|
||
|
|
- `tests/unit/v1/friendships/test_schemas.py`
|
||
|
|
|
||
|
|
**状态**: 测试实际可以正常运行，只是有警告提示。
|
||
|
|
|
||
|
|
**建议**: 可保持现状（这是合理的代码组织方式），或重命名为 `test_*.py` 以消除警告。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
### 3. 遗留测试验证旧字段 (INFO)
|
||
|
|
|
||
|
|
**文件**: `tests/unit/v1/profile/test_schemas.py`
|
||
|
|
|
||
|
|
**测试**: `test_profile_update_rejects_display_name_field`
|
||
|
|
|
||
|
|
**说明**: 此测试验证旧的 `display_name` 字段被正确拒绝。字段已在之前的重构中删除。
|
||
|
|
|
||
|
|
**状态**: **有效** - 这是一个回归测试，确保旧字段不被使用。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 未发现的问题
|
||
|
|
|
||
|
|
### 冗余测试
|
||
|
|
经过检查，未发现明显冗余的测试：
|
||
|
|
- 每个模块的测试覆盖不同的功能
|
||
|
|
- Unit tests、Integration tests、E2E tests 有清晰的职责划分
|
||
|
|
|
||
|
|
### 死代码
|
||
|
|
未发现测试文件中有未使用的:
|
||
|
|
- imports
|
||
|
|
- mock 类
|
||
|
|
- helper 函数
|
||
|
|
|
||
|
|
### 缺失测试
|
||
|
|
未发现对应已实现功能但缺少测试的情况。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 测试覆盖模块
|
||
|
|
|
||
|
|
### 后端
|
||
|
|
| 模块 | Unit | Integration | E2E |
|
||
|
|
|------|------|-------------|-----|
|
||
|
|
| Auth | ✅ | ✅ | ❌ |
|
||
|
|
| Users | - | ✅ | - |
|
||
|
|
| Profile | ✅ | - | ❌ |
|
||
|
|
| Friendships | ✅ | ✅ | - |
|
||
|
|
| Inbox Messages | ✅ | ✅ | - |
|
||
|
|
| Schedule Items | ✅ | ✅ | - |
|
||
|
|
| Logging | ✅ | ✅ | ✅ |
|
||
|
|
| Settings | ✅ | - | - |
|
||
|
|
|
||
|
|
### 前端
|
||
|
|
| 模块 | 测试数 |
|
||
|
|
|------|--------|
|
||
|
|
| Auth | ~20 |
|
||
|
|
| Chat | ~70 |
|
||
|
|
| Home | ~15 |
|
||
|
|
| Calendar | ~5 |
|
||
|
|
| Core (API, Storage) | ~30 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 建议
|
||
|
|
|
||
|
|
1. **立即**: 解决 E2E 测试依赖问题或移除无法运行的测试文件
|
||
|
|
2. **可选**: 清理 test_schemas.py 重名警告（低优先级）
|
||
|
|
3. **保持**: 现有的测试结构良好，无需重大重构
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 附: 测试代码质量问题
|
||
|
|
|
||
|
|
### 测试类未完全实现 Protocol (LSP 警告)
|
||
|
|
|
||
|
|
**文件**: `tests/unit/v1/auth/test_auth_service.py`
|
||
|
|
|
||
|
|
**问题**: `FakeGateway` 和 `LogoutAssertingGateway` 类没有实现 `AuthServiceGateway` Protocol 的全部方法：
|
||
|
|
- `request_password_reset`
|
||
|
|
- `confirm_password_reset`
|
||
|
|
|
||
|
|
**影响**: LSP 类型检查器报告错误，但运行时不受影响（因为这些方法在测试中不会被调用）。
|
||
|
|
|
||
|
|
**建议**: 可选择补充缺失的方法实现，或使用 `@pytest.mark.skip` 标记不需要的协议方法。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
*报告生成时间: 2026-03-04*
|