social-app/docs/bugs/test-analysis.md

前后端测试分析报告

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