156 lines
4.6 KiB
Markdown
156 lines
4.6 KiB
Markdown
# Fast Dashboard 项目
|
||
|
||
## 项目概述
|
||
智能评估仪表板系统，包含人才评估和工程研究中心评估功能。
|
||
|
||
## 技术栈
|
||
- 前端：Vue 3 + Element Plus + ECharts
|
||
- 后端：Python FastAPI + SQLite
|
||
- 部署：Docker + Nginx
|
||
|
||
## 近期问题记录
|
||
|
||
### 2024年 - 爬虫图片URL路径问题
|
||
|
||
**问题描述：**
|
||
- 爬虫返回的图片URL多了一个 `/szdw/` 路径
|
||
- 正确地址应该是：`https://ac.bit.edu.cn/images/2024-02/f5a28fd026884e328c2280ef42566f6b.png`
|
||
- 错误地址返回：`https://ac.bit.edu.cn/szdw/images/2024-02/f5a28fd026884e328c2280ef42566f6b.png`
|
||
|
||
**问题原因：**
|
||
- 在处理相对路径 `../../../` 时，原有逻辑从当前URL推断基础路径不准确
|
||
- 导致多拼接了 `/szdw/` 路径段
|
||
|
||
**解决方案：**
|
||
1. **修改图片URL处理逻辑** (`backend/main.py` 第610-625行)
|
||
- 简化相对路径处理，直接移除 `../../../` 前缀
|
||
- 统一使用基础URL (`https://ac.bit.edu.cn`) 拼接图片路径
|
||
- 增加对 `../../` 和 `../` 路径的处理
|
||
|
||
**修复后的代码逻辑：**
|
||
```python
|
||
if img_src.startswith('../../../'):
|
||
img_relative = img_src[9:] # 移除 '../../../'
|
||
img_url = f"{base_url}/{img_relative}"
|
||
elif img_src.startswith('../../'):
|
||
img_relative = img_src[6:] # 移除 '../../'
|
||
img_url = f"{base_url}/{img_relative}"
|
||
elif img_src.startswith('../'):
|
||
img_relative = img_src[3:] # 移除 '../'
|
||
img_url = f"{base_url}/{img_relative}"
|
||
```
|
||
|
||
### 2024年 - 人才评估接口网络连接问题
|
||
|
||
**问题描述：**
|
||
- 人才评估调用接口 `/api/scrape-url`
|
||
- 本地测试正常，服务器部署后报错500
|
||
- 错误信息：`HTTPSConnectionPool(host='ac.bit.edu.cn', port=443): Read timed out. (read timeout=30)`
|
||
|
||
**问题原因：**
|
||
1. **服务器网络环境限制**：服务器无法正常访问外部网站 ac.bit.edu.cn
|
||
2. **网络延迟问题**：服务器到目标网站的网络延迟较高，30秒超时不够
|
||
3. **DNS解析问题**：可能存在DNS配置问题
|
||
4. **防火墙限制**：服务器出站规则可能阻止了对目标域名的访问
|
||
|
||
**解决方案：**
|
||
|
||
1. **创建了改进版本的URL抓取函数** (`backend/scrape_url_improved.py`)
|
||
- 增加DNS解析检查
|
||
- 实现重试机制（最多3次重试）
|
||
- 延长超时时间（连接30秒，读取90秒）
|
||
- 添加详细的错误日志
|
||
- 临时禁用SSL验证避免证书问题
|
||
|
||
2. **创建了网络诊断工具** (`backend/network_diagnostic.py`)
|
||
- DNS解析测试
|
||
- TCP连接测试
|
||
- HTTP请求测试
|
||
- 系统网络配置检查
|
||
- 自动生成解决建议
|
||
|
||
**使用方法：**
|
||
|
||
```bash
|
||
# 进入后端目录
|
||
cd backend
|
||
|
||
# 激活conda环境
|
||
conda activate fast-dashboard-env
|
||
|
||
# 运行网络诊断工具
|
||
python network_diagnostic.py
|
||
|
||
# 或者在main.py中集成改进版本的抓取函数
|
||
```
|
||
|
||
**建议的部署检查项：**
|
||
1. 检查服务器DNS配置
|
||
2. 确认防火墙出站规则
|
||
3. 测试到目标网站的网络连通性
|
||
4. 考虑配置代理服务器
|
||
5. 检查云服务器安全组设置
|
||
|
||
## 环境配置
|
||
|
||
### Python环境
|
||
参考 `PYTHON_ENV_SETUP_README.md` 文档进行环境配置。
|
||
|
||
### 启动项目
|
||
|
||
#### 本地开发启动（仅本机访问）
|
||
```bash
|
||
# 后端启动
|
||
cd backend
|
||
conda activate fast-dashboard-env
|
||
uvicorn main:app --reload
|
||
|
||
# 前端启动
|
||
npm run dev
|
||
```
|
||
|
||
#### IP网络访问启动（局域网内其他设备可访问）
|
||
|
||
**方法1：使用便捷启动脚本**
|
||
```bash
|
||
# 双击运行根目录下的 start_with_ip.bat 文件
|
||
# 或在命令行中运行：
|
||
start_with_ip.bat
|
||
```
|
||
|
||
**方法2：手动启动**
|
||
```bash
|
||
# 后端启动 (监听所有IP)
|
||
cd backend
|
||
conda activate fast-dashboard-env
|
||
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
|
||
|
||
# 前端启动 (监听所有IP)
|
||
npm run dev -- --host 0.0.0.0
|
||
```
|
||
|
||
#### 访问地址
|
||
- **本地访问**: http://localhost:5173 (前端) | http://localhost:8000 (后端)
|
||
- **网络访问**: http://您的IP:5173 (前端) | http://您的IP:8000 (后端)
|
||
- **当前您的IP**: http://192.168.18.108:5173 (前端) | http://192.168.18.108:8000 (后端)
|
||
|
||
#### 防火墙配置
|
||
如果其他设备无法访问，请确保Windows防火墙允许以下端口：
|
||
- 端口 5173 (前端)
|
||
- 端口 8000 (后端)
|
||
|
||
## 文件结构
|
||
```
|
||
fast-dashboard/
|
||
├── backend/ # 后端代码
|
||
│ ├── main.py # 主应用文件
|
||
│ ├── scrape_url_improved.py # 改进版URL抓取
|
||
│ ├── network_diagnostic.py # 网络诊断工具
|
||
│ └── ...
|
||
├── src/ # 前端代码
|
||
│ ├── components/ # Vue组件
|
||
│ └── ...
|
||
├── README.md # 项目文档
|
||
└── PYTHON_ENV_SETUP_README.md # Python环境配置文档
|
||
```
|