203 lines
3.2 KiB
Markdown
203 lines
3.2 KiB
Markdown
|
# Bug报告模板
|
|||
|
|
|
|||
|
|
**使用说明：** 每发现一个Bug，复制下面的模板填写
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Bug #[编号]
|
|||
|
|
|
|||
|
|
**标题：** [一句话描述问题]
|
|||
|
|
|
|||
|
|
**严重程度：**
|
|||
|
|
- [ ] P0 - 阻塞性（系统崩溃/无法启动/核心功能不可用）
|
|||
|
|
- [ ] P1 - 严重（主要功能异常/数据错误）
|
|||
|
|
- [ ] P2 - 一般（界面问题/提示不清晰/性能问题）
|
|||
|
|
- [ ] P3 - 建议（优化建议/文档问题）
|
|||
|
|
|
|||
|
|
**发现时间：** 2026-01-XX XX:XX
|
|||
|
|
|
|||
|
|
**发现人：** [你的名字]
|
|||
|
|
|
|||
|
|
**影响范围：**
|
|||
|
|
- [ ] 云端
|
|||
|
|
- [ ] 边缘端
|
|||
|
|
- [ ] 端到端联调
|
|||
|
|
- [ ] 其他：__________
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 问题描述
|
|||
|
|
|
|||
|
|
[清晰描述问题是什么，用户会看到什么]
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 复现步骤
|
|||
|
|
|
|||
|
|
**前置条件：**
|
|||
|
|
- [例如：云端服务正在运行]
|
|||
|
|
- [例如：已安装所有依赖]
|
|||
|
|
|
|||
|
|
**复现步骤：**
|
|||
|
|
1. [第一步]
|
|||
|
|
2. [第二步]
|
|||
|
|
3. [第三步]
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 预期结果
|
|||
|
|
|
|||
|
|
[应该发生什么]
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 实际结果
|
|||
|
|
|
|||
|
|
[实际发生了什么]
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 环境信息
|
|||
|
|
|
|||
|
|
**操作系统：** Windows 10 / macOS XX / Linux
|
|||
|
|
**Python版本：** 3.x.x
|
|||
|
|
**关键依赖版本：**
|
|||
|
|
- Flask: x.x.x
|
|||
|
|
- numpy: x.x.x
|
|||
|
|
|
|||
|
|
**配置信息：**
|
|||
|
|
- device_id: xxxx
|
|||
|
|
- API Key: xxxx（前4位）
|
|||
|
|
- 云端地址: xxxx
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 日志与截图
|
|||
|
|
|
|||
|
|
**错误日志：**
|
|||
|
|
```
|
|||
|
|
[粘贴关键错误日志，至少前后20行]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**完整日志文件：**
|
|||
|
|
- `artifacts/xxx/error.log`
|
|||
|
|
|
|||
|
|
**截图：**
|
|||
|
|
- `artifacts/xxx/screenshot.png`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 建议解决方案
|
|||
|
|
|
|||
|
|
[如果你有想法，写下来；没有也可以留空]
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 状态跟踪
|
|||
|
|
|
|||
|
|
- [ ] 已报告
|
|||
|
|
- [ ] 开发中
|
|||
|
|
- [ ] 已修复
|
|||
|
|
- [ ] 已验证
|
|||
|
|
- [ ] 已关闭
|
|||
|
|
|
|||
|
|
**修复责任人：** __________
|
|||
|
|
**预计修复时间：** __________
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Bug示例（参考）
|
|||
|
|
|
|||
|
|
### Bug #001
|
|||
|
|
|
|||
|
|
**标题：** 云端启动时数据库连接失败
|
|||
|
|
|
|||
|
|
**严重程度：** P0 - 阻塞性
|
|||
|
|
|
|||
|
|
**发现时间：** 2026-01-12 10:15
|
|||
|
|
|
|||
|
|
**发现人：** 测试成员A
|
|||
|
|
|
|||
|
|
**影响范围：** ✅ 云端
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 问题描述
|
|||
|
|
|
|||
|
|
运行 `python cloud_hypertension_system.py` 后，系统报错退出，提示数据库连接失败。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 复现步骤
|
|||
|
|
|
|||
|
|
**前置条件：**
|
|||
|
|
- Python 3.8已安装
|
|||
|
|
- 已执行 `pip install -r requirements.txt`
|
|||
|
|
|
|||
|
|
**复现步骤：**
|
|||
|
|
1. 打开PowerShell
|
|||
|
|
2. 导航到项目目录
|
|||
|
|
3. 执行 `python cloud_hypertension_system.py`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 预期结果
|
|||
|
|
|
|||
|
|
云端服务正常启动，显示：
|
|||
|
|
```
|
|||
|
|
✓ 数据库初始化成功
|
|||
|
|
Running on http://127.0.0.1:5000
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 实际结果
|
|||
|
|
|
|||
|
|
程序报错退出：
|
|||
|
|
```
|
|||
|
|
sqlite3.OperationalError: unable to open database file
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 环境信息
|
|||
|
|
|
|||
|
|
**操作系统：** Windows 10
|
|||
|
|
**Python版本：** 3.9.7
|
|||
|
|
**SQLite版本：** 3.35.5
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 日志与截图
|
|||
|
|
|
|||
|
|
**错误日志：**
|
|||
|
|
```
|
|||
|
|
Traceback (most recent call last):
|
|||
|
|
File "cloud_hypertension_system.py", line 850, in init_database
|
|||
|
|
self.db_manager = DatabaseManager(self.config.database_config)
|
|||
|
|
File "cloud_hypertension_system.py", line 125, in __init__
|
|||
|
|
self.engine = create_engine(...)
|
|||
|
|
sqlite3.OperationalError: unable to open database file
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**完整日志：** `artifacts/cloud/startup_error.log`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 建议解决方案
|
|||
|
|
|
|||
|
|
检查数据库文件路径是否存在写权限。可能需要：
|
|||
|
|
1. 手动创建数据库目录
|
|||
|
|
2. 或者修改数据库路径到用户目录
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 状态跟踪
|
|||
|
|
|
|||
|
|
- [x] 已报告（2026-01-12）
|
|||
|
|
- [ ] 开发中
|
|||
|
|
- [ ] 已修复
|
|||
|
|
- [ ] 已验证
|
|||
|
|
- [ ] 已关闭
|