From 1bc330e20ce6a24d4f94ee3eb3c46f71b2973af5 Mon Sep 17 00:00:00 2001 From: chenqi Date: Sat, 28 Feb 2026 15:05:30 +0800 Subject: [PATCH] first commit --- frontend/DEBUG_GUIDE.md | 118 ++++++++++++++++++++++++++++++ frontend/public/test-api.html | 132 ++++++++++++++++++++++++++++++++++ 2 files changed, 250 insertions(+) create mode 100644 frontend/DEBUG_GUIDE.md create mode 100644 frontend/public/test-api.html diff --git a/frontend/DEBUG_GUIDE.md b/frontend/DEBUG_GUIDE.md new file mode 100644 index 0000000..712af28 --- /dev/null +++ b/frontend/DEBUG_GUIDE.md @@ -0,0 +1,118 @@ +# 前端接口调试指南 + +## 问题诊断步骤 + +### 1. 打开浏览器开发者工具 +- 按 F12 或右键 → 检查 +- 切换到 **Console（控制台）** 标签 +- 切换到 **Network（网络）** 标签 + +### 2. 查看控制台错误 +在控制台查看具体的错误信息，常见错误： + +#### 错误类型 1: CORS 错误 +``` +Access to XMLHttpRequest at 'http://localhost:8000/api/v1/...' +from origin 'http://localhost:5173' has been blocked by CORS policy +``` +**解决方法**: 这是正常的，说明请求到达了后端，检查后端 CORS 配置 + +#### 错误类型 2: 404 Not Found +``` +GET http://localhost:5173/api/v1/departments 404 (Not Found) +``` +**原因**: Vite 代理配置问题 +**解决方法**: 重启前端开发服务器 + +#### 错误类型 3: 500 Internal Server Error +``` +POST http://localhost:8000/api/v1/auth/login 500 (Internal Server Error) +``` +**原因**: 后端服务错误 +**解决方法**: 检查后端日志 `backend/logs/error_*.log` + +#### 错误类型 4: Network Error +``` +Error: Network Error +``` +**原因**: 后端服务未运行 +**解决方法**: 启动后端服务 `cd backend && uvicorn app.main:app --reload` + +### 3. 查看网络请求 + +在 Network 标签中： +1. 找到失败的请求（红色） +2. 点击请求查看详情 +3. 查看 **Response（响应）** 标签，查看后端返回的错误信息 + +### 4. 常见接口错误及解决 + +#### 登录失败 +**检查点**: +- 后端是否运行：访问 http://localhost:8000/health +- 账号密码是否正确：admin / admin123 +- Content-Type 是否为 `application/x-www-form-urlencoded` + +#### 科室/员工/指标列表失败 +**检查点**: +- 是否已登录获取 token +- token 是否过期 +- 请求头是否包含 `Authorization: Bearer {token}` + +#### 统计报表失败 +**检查点**: +- 参数是否正确（period_year, period_month） +- 数据库中是否有对应数据 + +### 5. 快速测试工具 + +访问 http://localhost:5173/test-api.html 使用内置的 API 测试工具 + +### 6. 清除缓存 + +如果遇到问题： +1. 清除浏览器缓存：Ctrl+Shift+Delete +2. 清除 localStorage: + ```javascript + localStorage.clear() + ``` +3. 硬刷新：Ctrl+F5 + +### 7. 重启服务 + +如果以上都无效： +```bash +# 停止所有 Python 进程 +powershell -Command "Get-Process | Where-Object {$_.ProcessName -eq 'python'} | Stop-Process -Force" + +# 重启后端 +cd D:\医院绩效系统\backend +python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000 + +# 重启前端（新终端） +cd D:\医院绩效系统\frontend +npm run dev +``` + +## 当前系统状态 + +### 后端状态 +- 地址：http://localhost:8000 +- 健康检查：http://localhost:8000/health +- API 文档：http://localhost:8000/api/v1/docs +- 日志目录：`backend/logs/` + +### 前端状态 +- 地址：http://localhost:5173 +- Vite 配置：代理 `/api` 到 `http://localhost:8000` + +### 默认账号 +- 用户名：admin +- 密码：admin123 + +## 联系支持 + +如果问题仍未解决，请提供： +1. 控制台错误截图 +2. Network 标签中失败请求的详情 +3. 后端日志内容 diff --git a/frontend/public/test-api.html b/frontend/public/test-api.html new file mode 100644 index 0000000..00a574e --- /dev/null +++ b/frontend/public/test-api.html @@ -0,0 +1,132 @@ + + + + + API 测试 + + + +

前端 API 测试

+ +
+ + + + + + +
+ +
+ + + +