WIP-CHECKPOINT[auth-refactor]: 固化工程师崩溃前部分成果 + 同树其他未提交WIP（仅源码，不含密钥/二进制）-- 待重激活工程师续作
This commit is contained in:
Simon
@@ -83,7 +83,7 @@ docs/
|
||||
|
||||
| 文档 | 说明 |
|
||||
|------|------|
|
||||
| `03-调试验证指南-20260613.md` | 调试验证指南 |
|
||||
| `09-部署运维/00-标准故障排查手册.md`(§5 验证标准) | 标准故障排查 + 端到端验证 |
|
||||
| `testing-测试/E2E-CHECKLIST-v0.7.0.md` | E2E 验收清单 |
|
||||
| `testing-测试/TESTING_CALL_AGENT.md` | 呼叫坐席测试 |
|
||||
| `testing-测试/QA_COMPREHENSIVE_REPORT.md` | QA 综合报告 |
|
||||
@@ -112,7 +112,7 @@ docs/
|
||||
| 文档 | 说明 |
|
||||
|------|------|
|
||||
| `deploy/03-RELEASE-NOTES-v0.7.1-20260623.md` | v0.7.1 发布说明 |
|
||||
| `deploy/04-部署修复记录-20260613.md` | 部署修复记录 |
|
||||
| `00-标准故障排查手册.md` | 标准故障排查手册（含历史修复案例）|
|
||||
| `deploy/05-版本更新说明-v1.1.0-20260614.md` | 版本更新说明 v1.1.0 |
|
||||
| `deploy/06-OTP二次验证实现.md` | OTP 二次验证实现 |
|
||||
| `deploy/07-扫码登录OTP部署指南-v0.7.0.md` | 扫码登录OTP部署指南 |
|
||||
@@ -120,7 +120,7 @@ docs/
|
||||
| `deploy/09-NAS部署指南-群晖Cloudflare.md` | NAS部署指南(群晖) |
|
||||
| `deploy/10-一键部署操作包-v0.7.0.md` | 一键部署操作包 |
|
||||
| `deploy/` | 7 | 部署文档 |
|
||||
| `troubleshooting-故障排查/` | 1 | 故障排查 |
|
||||
| `00-标准故障排查手册.md` | 标准故障排查手册（首查入口）|
|
||||
| `guides-用户指南/` | 1 | 用户指南 |
|
||||
|
||||
### 10-项目管理/
|
||||
@@ -146,7 +146,7 @@ docs/
|
||||
|------|---------|
|
||||
| 新人入职 | `01-项目总览/01-项目总览与部署手册-20260704.md` |
|
||||
| 部署上线 | `01-项目总览/01-智能IT服务系统运维手册-20260704.md` |
|
||||
| 故障排查 | `09-部署运维/troubleshooting-故障排查/` |
|
||||
| 故障排查 | `09-部署运维/00-标准故障排查手册.md` |
|
||||
| 代码评审 | `07-代码评审/评审报告-代码评审/` |
|
||||
| 安全合规 | `08-安全审计/` |
|
||||
| 运维操作 | `10-项目管理/SOPs-标准流程/` |
|
||||
|
||||
@@ -244,120 +244,11 @@ df -h # 磁盘空间
|
||||
|
||||
## 五、故障排查
|
||||
|
||||
### 5.1 快速诊断流程
|
||||
|
||||
```
|
||||
1. 检查容器状态 → 2. 检查端口连通 → 3. 检查日志 → 4. 定位根因
|
||||
```
|
||||
|
||||
### 5.2 常见问题
|
||||
|
||||
#### 问题 1: 访问返回 500 错误
|
||||
|
||||
```bash
|
||||
# 1. 检查容器状态
|
||||
docker compose ps
|
||||
|
||||
# 2. 检查后端日志
|
||||
docker compose logs --tail=100 backend
|
||||
|
||||
# 3. 检查 nginx 日志
|
||||
docker compose logs --tail=100 nginx
|
||||
|
||||
# 4. 检查前端 dist 是否存在
|
||||
ls /opt/wecom-it-desk/frontend-h5/dist/
|
||||
docker compose exec nginx ls /usr/share/nginx/html/itdesk/
|
||||
```
|
||||
|
||||
#### 问题 2: API 返回连接错误
|
||||
|
||||
```bash
|
||||
# 1. 检查后端是否启动
|
||||
docker compose ps backend
|
||||
|
||||
# 2. 检查后端健康端点
|
||||
curl http://localhost:8000/health
|
||||
|
||||
# 3. 检查数据库连接
|
||||
docker compose exec backend python -c "from app.database import get_db; print('OK')"
|
||||
```
|
||||
|
||||
#### 问题 3: WebSocket 连接失败
|
||||
|
||||
```bash
|
||||
# 1. 检查 nginx WebSocket 配置
|
||||
docker compose exec nginx cat /etc/nginx/nginx.conf | grep -A10 ws
|
||||
|
||||
# 2. 检查 WS 端点
|
||||
curl -I http://localhost:8000/ws/test
|
||||
|
||||
# 3. 检查 Redis（WS 依赖）
|
||||
docker compose exec redis redis-cli ping
|
||||
```
|
||||
|
||||
#### 问题 4: 企微工作台打开页面显示"加载失败"或无限加载（2026-07-04）
|
||||
|
||||
**现象**：员工通过企业微信-工作台-IT支持服务访问，显示加载失败或一直转圈
|
||||
|
||||
**排查步骤**：
|
||||
|
||||
```bash
|
||||
# 1. 检查容器状态
|
||||
docker ps
|
||||
|
||||
# 2. 检查 nginx 是否正确加载配置
|
||||
docker exec wecom_it_nginx nginx -t
|
||||
|
||||
# 3. 检查前端页面访问
|
||||
curl -I http://localhost/itdesk/
|
||||
|
||||
# 4. 检查 API 代理
|
||||
curl -I http://localhost/api/h5/health
|
||||
|
||||
# 5. 查看后端日志（查找 NameError）
|
||||
docker logs --tail=50 wecom_it_backend | grep -i error
|
||||
```
|
||||
|
||||
**根因 1**：nginx 容器未正确挂载 nginx.conf 配置文件
|
||||
- 表现：API 请求返回 404，nginx 错误日志显示 `open() "/usr/share/nginx/html/api/xxx" failed`
|
||||
- 解决：重建 nginx 容器，确保正确挂载配置
|
||||
|
||||
```bash
|
||||
# 重建 nginx 容器
|
||||
docker rm -f wecom_it_nginx
|
||||
docker run -d --name wecom_it_nginx \
|
||||
--network wecom-it-desk_it-desk-internal \
|
||||
-p 80:80 -p 443:443 \
|
||||
-v /opt/wecom-it-desk/html:/usr/share/nginx/html:ro \
|
||||
-v /opt/wecom-it-desk/nginx/nginx.conf:/etc/nginx/nginx.conf:ro \
|
||||
-v /opt/wecom-it-desk/nginx/ssl:/etc/nginx/ssl:rw \
|
||||
--restart unless-stopped nginx:1.27-alpine
|
||||
|
||||
# 重新加载配置
|
||||
docker exec wecom_it_nginx nginx -s reload
|
||||
```
|
||||
|
||||
**根因 2**：后端 h5.py 代码存在 NameError
|
||||
- 表现：后端日志显示 `NameError: name '_require_wework_ua' is not defined`
|
||||
- 原因：生产服务器代码未同步最新版本
|
||||
- 解决：复制最新代码并重启后端
|
||||
|
||||
```bash
|
||||
# 复制最新代码
|
||||
docker cp /opt/wecom-it-desk/backend/app/api/h5.py wecom_it_backend:/app/app/api/h5.py
|
||||
|
||||
# 重启后端
|
||||
docker restart wecom_it_backend
|
||||
```
|
||||
|
||||
### 5.3 完整诊断脚本
|
||||
|
||||
详细诊断脚本见：`docs/deploy/服务器端跑诊断.md`
|
||||
|
||||
```bash
|
||||
# 一键诊断
|
||||
bash /opt/wecom-it-desk/diagnose-500.sh
|
||||
```
|
||||
> **本章已整合至标准故障排查手册**：[09-部署运维/00-标准故障排查手册.md](../09-部署运维/00-标准故障排查手册.md)
|
||||
>
|
||||
> 手册涵盖：三步隔离法、错误码速查（500/502/503/403/422/网络挂起）、诊断脚本与命令、案例库（含 Redis urlparse 挂起、502、各类修复记录）、端到端验证完成标准（含"宣布修复前必须提供真实浏览器截图"硬规则）。
|
||||
>
|
||||
> **日常排故请直接打开该手册**，本文档不再重复故障排查细节。
|
||||
|
||||
---
|
||||
|
||||
@@ -486,8 +377,7 @@ docker compose logs nginx > /tmp/incident-nginx.log
|
||||
| `docs/01-项目总览/01-项目总览与部署手册-20260704.md` | 完整项目背景与架构设计 |
|
||||
| `docs/RELEASE_NOTES_v0.7.1.md` | 版本发布说明 |
|
||||
| `docs/SOPs/SOP-004-应急响应.md` | 详细应急响应流程 |
|
||||
| `docs/deploy/快速诊断-500-错误.md` | 500 错误排查指南 |
|
||||
| `docs/09-部署运维/deploy/04-部署修复记录-20260613.md` | 历史修复记录 |
|
||||
| `09-部署运维/00-标准故障排查手册.md` | 标准故障排查手册（故障排查唯一入口）|
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user