zsglpt/BUG_REPORT.md

zsglpt项目Bug发现报告

📋 测试环境

• 操作系统: Windows
• Python版本: 3.12.10
• 测试时间: 2026-01-16
• 应用端口: 51233

🚨 发现的主要Bug

Bug #1: Unicode字符编码问题【已修复】

严重等级: 高
影响范围: 全局
问题描述: 项目中大量使用Unicode字符（✓、🔒等），在Windows环境下导致编码错误

错误信息:

UnicodeEncodeError: 'gbk' codec can't encode character '\u2713' in position 0: illegal multibyte sequence

影响:

• 项目无法在Windows环境下正常启动
• 所有包含Unicode字符的功能都会出错
• 严重影响跨平台兼容性

修复状态: ✅ 已修复 修复方法: 批量替换所有Unicode字符为ASCII替代

---

Bug #2: 双重用户系统设计问题

严重等级: 中
影响范围: 用户管理、权限控制
问题描述: 项目维护两套独立的用户系统

技术细节:

-- 系统1: 普通用户
CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    username TEXT UNIQUE,
    password_hash TEXT,
    ...
);

-- 系统2: 管理员
CREATE TABLE admins (
    id INTEGER PRIMARY KEY, 
    username TEXT UNIQUE,
    password_hash TEXT,
    ...
);

问题影响:

• 用户混淆，不知道应该用哪个系统
• 代码维护复杂度增加
• 权限管理逻辑复杂
• 可能导致安全漏洞

建议修复:

• 合并为单一用户系统
• 使用角色/权限模型区分管理员和普通用户

---

Bug #3: URL路由命名不一致

严重等级: 中
影响范围: API调用、前端集成
问题描述: API路径设计不规范，命名混乱

具体问题:

• 普通用户API: /api/login
• 管理员API: /yuyx/api/login
• 路径前缀不一致
• "yuyx"命名无明确含义

建议修复:

• 标准化API路径命名
• 使用RESTful设计规范
• 统一路径前缀策略

---

✅ 正常工作的功能

1. 应用启动和基础服务

• ✅ Flask应用正常启动
• ✅ 数据库连接池工作正常
• ✅ SQLite数据库初始化成功
• ✅ 截图线程池启动成功（3个worker）
• ✅ API预热功能正常
• ✅ 健康检查API (/health) 响应正常

2. 安全系统

• ✅ 风险评估系统工作
• ✅ 访问控制正常
• ✅ 未认证请求正确拒绝

3. 管理员系统

• ✅ 默认管理员账号创建成功
• ✅ 管理员登录API工作正常
• ✅ 管理员后台页面加载正常

4. 前端界面

• ✅ 用户登录页面正常显示
• ✅ 中文字符在HTML中显示正常
• ✅ CSS和JavaScript资源加载正常

---

📊 功能测试结果

功能模块	测试状态	备注
应用启动	✅ 正常	需要Unicode修复
数据库	✅ 正常	SQLite连接正常
健康检查	✅ 正常	返回ok=true
用户登录	✅ 正常	API返回正确重定向
管理员登录	✅ 正常	/yuyx/api/login工作
普通用户API	⚠️ 部分	需要进一步测试
前端页面	✅ 正常	HTML渲染正常
文件上传	❓ 未测试	需要配置
任务调度	❓ 未测试	需要触发

---

🔍 发现的架构问题

1. 跨平台兼容性问题

问题: 缺乏跨平台测试，开发时主要在Linux环境 影响: Windows用户无法正常使用 建议: 建立跨平台测试流程

2. 编码规范问题

问题: 混合使用Unicode和ASCII字符 影响: 编码错误、维护困难 建议: 统一使用UTF-8或纯ASCII

3. 命名规范问题

问题: API路径、变量命名不一致 影响: 代码可读性差、API难以使用 建议: 建立命名规范文档

---

🧪 建议的测试方案

1. 基础功能测试

# 测试应用启动
python app.py

# 测试健康检查
curl http://127.0.0.1:51233/health

# 测试管理员登录
curl -X POST -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"PASSWORD"}' \
  http://127.0.0.1:51233/yuyx/api/login

2. 用户功能测试

• 测试用户注册/登录流程
• 测试任务提交功能
• 测试截图功能
• 测试文件上传功能

3. 管理员功能测试

• 测试用户管理功能
• 测试系统配置功能
• 测试任务监控功能

4. 性能测试

• 测试并发用户访问
• 测试数据库性能
• 测试内存使用情况

---

📈 优化建议

1. 立即处理（高优先级）

• 修复Unicode编码问题
• 统一API路径命名
• 建立错误处理机制
• 添加日志记录

2. 短期改进（中优先级）

• 合并用户系统
• 建立测试套件
• 优化数据库设计
• 改进错误提示

3. 长期优化（低优先级）

• 重构架构设计
• 添加性能监控
• 建立CI/CD流程
• 完善文档

---

💡 总结

项目基础架构良好，大部分核心功能正常工作。主要问题集中在：

1. 编码兼容性 - 需要跨平台测试
2. 架构设计 - 用户系统需要重构
3. 命名规范 - 需要标准化

修复这些bug后，项目将具备良好的跨平台兼容性和可维护性。

测试完成度: 30%
发现Bug数: 3个（1个已修复）
建议优先级: 高
项目可用性: 基本可用，需要修复编码问题