144 lines
3.6 KiB
Markdown
144 lines
3.6 KiB
Markdown
# 故障排查指南
|
||
|
||
## 问题：未能提取到成绩信息，共 0 门课程
|
||
|
||
### 症状
|
||
日志中出现以下警告信息：
|
||
```
|
||
[WARNING] 未能提取到成绩信息，返回原始文本
|
||
[INFO] 成绩无变化（共 0 门课程）
|
||
```
|
||
|
||
### 可能的原因和解决方案
|
||
|
||
#### 1. BeautifulSoup 未安装
|
||
**检查方法：**
|
||
```bash
|
||
python3 -c "import bs4; print('BeautifulSoup4 已安装')"
|
||
```
|
||
|
||
**解决方案：**
|
||
```bash
|
||
pip3 install beautifulsoup4
|
||
# 或
|
||
pip3 install -r requirements.txt
|
||
```
|
||
|
||
#### 2. 登录会话失效
|
||
**症状：** 日志中可能出现 "检测到登录页面" 的错误
|
||
|
||
**解决方案：**
|
||
```bash
|
||
# 停止服务
|
||
systemctl stop grade-monitor
|
||
|
||
# 重新启动服务（会重新登录）
|
||
systemctl start grade-monitor
|
||
```
|
||
|
||
#### 3. 网页结构变化
|
||
**检查方法：**
|
||
程序会自动保存 HTML 到 `debug_page.html`，查看这个文件：
|
||
```bash
|
||
# 查看 debug_page.html 是否存在
|
||
ls -la ~/grade_monitor/debug_page.html
|
||
|
||
# 查看 HTML 内容，确认是否有成绩表格
|
||
grep -i "gridtable\|课程名称\|成绩" ~/grade_monitor/debug_page.html
|
||
```
|
||
|
||
**解决方案：**
|
||
如果网页结构变化，可能需要修改 `monitor.py` 中的 `extract_grade_info` 函数。
|
||
当前支持的表格选择器：
|
||
- `<table class="gridtable">`
|
||
- `<table id="dataList">`
|
||
- 任何包含"课程名称"或"成绩"关键词的表格
|
||
|
||
#### 4. 启用调试模式排查
|
||
|
||
**临时测试（手动运行）：**
|
||
```bash
|
||
cd ~/grade_monitor
|
||
python3 monitor.py --test --debug
|
||
```
|
||
|
||
**查看详细日志：**
|
||
```bash
|
||
# 启用调试模式修改服务配置
|
||
sudo nano /etc/systemd/system/grade-monitor.service
|
||
|
||
# 在 ExecStart 行添加 --debug 参数
|
||
ExecStart=/usr/bin/python3 /home/yourusername/grade_monitor/monitor.py --debug
|
||
|
||
# 重新加载并重启
|
||
sudo systemctl daemon-reload
|
||
sudo systemctl restart grade-monitor
|
||
|
||
# 查看详细日志
|
||
tail -f ~/grade_monitor/monitor.log
|
||
```
|
||
|
||
#### 5. 检查保存的文件
|
||
```bash
|
||
cd ~/grade_monitor
|
||
|
||
# 查看上次提取的成绩内容
|
||
cat .last_grade_content.txt
|
||
|
||
# 查看上次保存的 HTML（如果存在）
|
||
cat .last_grade_page.html | head -50
|
||
|
||
# 查看调试 HTML（出错时自动保存）
|
||
cat debug_page.html | head -50
|
||
```
|
||
|
||
### 调试流程
|
||
|
||
1. **启用调试模式运行一次测试：**
|
||
```bash
|
||
cd ~/grade_monitor
|
||
python3 monitor.py --test --debug
|
||
```
|
||
|
||
2. **查看输出信息：**
|
||
- 是否显示 "找到成绩表格"？
|
||
- 是否显示 "找到 X 行成绩数据"？
|
||
- 是否显示 "共解析到 X 门课程"？
|
||
|
||
3. **检查保存的文件：**
|
||
```bash
|
||
# 如果生成了 debug_page.html
|
||
ls -lh debug_page.html
|
||
|
||
# 查看是否包含成绩表格
|
||
grep -A 5 "gridtable\|dataList" debug_page.html
|
||
```
|
||
|
||
4. **如果是网页结构问题：**
|
||
- 将 `debug_page.html` 发给开发者
|
||
- 或者自己检查 HTML 中的表格结构
|
||
- 修改 `extract_grade_info` 函数中的选择器
|
||
|
||
### 常见问题
|
||
|
||
**Q: 日志显示"未找到成绩表格"**
|
||
A: 网页结构可能变化，需要查看 debug_page.html 确认实际的表格结构
|
||
|
||
**Q: 日志显示"找到 0 行成绩数据"**
|
||
A: 表格找到了但是为空，可能是：
|
||
- 登录失效，返回的是空表格
|
||
- 实际就是没有成绩数据
|
||
|
||
**Q: 日志显示"检测到未解析的HTML内容"**
|
||
A: BeautifulSoup 解析失败，返回了原始 HTML。检查：
|
||
1. BeautifulSoup 是否正确安装
|
||
2. HTML 格式是否正确（查看 debug_page.html）
|
||
|
||
### 联系支持
|
||
|
||
如果以上方法都无法解决问题，请提供：
|
||
1. `monitor.log` 的最后 50 行
|
||
2. `debug_page.html` 文件（如果存在）
|
||
3. `.last_grade_content.txt` 文件内容
|
||
4. 是否能手动登录并看到成绩页面
|