148 lines
3.2 KiB
Markdown
148 lines
3.2 KiB
Markdown
|
# Graph-RAG-Agent 服务未运行问题解决方案
|
|||
|
|
|
|||
|
|
## 问题描述
|
|||
|
|
|
|||
|
|
错误信息：
|
|||
|
|
```
|
|||
|
|
连接错误: HTTPConnectionPool(host='localhost', port=8000): Max retries exceeded with url: /chat/stream
|
|||
|
|
(Caused by NewConnectionError('<urllib3.connection.HTTPConnection object at 0x000001DD24E19F60>:
|
|||
|
|
Failed to establish a new connection: [WinError 10061] 由于目标计算机积极拒绝，无法连接。'))
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
这表明 graph-rag-agent 服务没有在 8000 端口运行。
|
|||
|
|
|
|||
|
|
## 解决步骤
|
|||
|
|
|
|||
|
|
### 1. 首先恢复 CORS 支持
|
|||
|
|
|
|||
|
|
由于你恢复了原始文件，需要重新添加 CORS 支持：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd ~/graph-rag-agent/server
|
|||
|
|
cp main.py.cors_backup main.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或者手动编辑 main.py，在导入部分添加：
|
|||
|
|
```python
|
|||
|
|
from fastapi.middleware.cors import CORSMiddleware
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
在 `app = FastAPI(...)` 之后添加：
|
|||
|
|
```python
|
|||
|
|
# 配置 CORS
|
|||
|
|
app.add_middleware(
|
|||
|
|
CORSMiddleware,
|
|||
|
|
allow_origins=["*"], # 允许所有源
|
|||
|
|
allow_credentials=True,
|
|||
|
|
allow_methods=["*"],
|
|||
|
|
allow_headers=["*"],
|
|||
|
|
)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 检查依赖是否安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd ~/graph-rag-agent
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 检查 Neo4j 是否运行
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Windows PowerShell
|
|||
|
|
netstat -an | findstr 7687
|
|||
|
|
|
|||
|
|
# 或在 WSL/Linux 中
|
|||
|
|
sudo lsof -i :7687
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. 启动 graph-rag-agent 服务
|
|||
|
|
|
|||
|
|
在 Windows 中：
|
|||
|
|
```bash
|
|||
|
|
cd C:\path\to\graph-rag-agent
|
|||
|
|
python -m uvicorn server.main:app --reload --host 0.0.0.0 --port 8000
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
在 WSL/Linux 中：
|
|||
|
|
```bash
|
|||
|
|
cd ~/graph-rag-agent
|
|||
|
|
python -m uvicorn server.main:app --reload --host 0.0.0.0 --port 8000
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 5. 常见启动问题
|
|||
|
|
|
|||
|
|
#### 问题 1：ModuleNotFoundError
|
|||
|
|
```
|
|||
|
|
ModuleNotFoundError: No module named 'xxx'
|
|||
|
|
```
|
|||
|
|
解决：安装缺失的模块
|
|||
|
|
```bash
|
|||
|
|
pip install xxx
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 问题 2：Neo4j 连接失败
|
|||
|
|
```
|
|||
|
|
neo4j.exceptions.ServiceUnavailable: Unable to connect to localhost:7687
|
|||
|
|
```
|
|||
|
|
解决：
|
|||
|
|
1. 启动 Neo4j 服务
|
|||
|
|
2. 检查 config/settings.py 中的 Neo4j 配置
|
|||
|
|
|
|||
|
|
#### 问题 3：端口被占用
|
|||
|
|
```
|
|||
|
|
[Errno 48] Address already in use
|
|||
|
|
```
|
|||
|
|
解决：
|
|||
|
|
1. 查找占用端口的进程：
|
|||
|
|
```bash
|
|||
|
|
# Windows
|
|||
|
|
netstat -ano | findstr :8000
|
|||
|
|
|
|||
|
|
# Linux/Mac
|
|||
|
|
lsof -i :8000
|
|||
|
|
```
|
|||
|
|
2. 终止进程或使用其他端口
|
|||
|
|
|
|||
|
|
### 6. 验证服务是否启动
|
|||
|
|
|
|||
|
|
1. 在浏览器访问：
|
|||
|
|
```
|
|||
|
|
http://localhost:8000/docs
|
|||
|
|
```
|
|||
|
|
应该看到 FastAPI 的 API 文档页面
|
|||
|
|
|
|||
|
|
2. 使用 curl 测试：
|
|||
|
|
```bash
|
|||
|
|
curl http://localhost:8000/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. 测试 CORS：
|
|||
|
|
```bash
|
|||
|
|
curl -I -X OPTIONS http://localhost:8000/chat \
|
|||
|
|
-H "Origin: http://localhost:3000" \
|
|||
|
|
-H "Access-Control-Request-Method: POST"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 7. 完整启动流程
|
|||
|
|
|
|||
|
|
1. **启动 Neo4j**（如果需要）
|
|||
|
|
2. **恢复 CORS 配置**
|
|||
|
|
3. **启动 graph-rag-agent**：
|
|||
|
|
```bash
|
|||
|
|
cd ~/graph-rag-agent
|
|||
|
|
python -m uvicorn server.main:app --reload --host 0.0.0.0 --port 8000
|
|||
|
|
```
|
|||
|
|
4. **启动前端**（在另一个终端）：
|
|||
|
|
```bash
|
|||
|
|
cd ~/yundage-backserver-test
|
|||
|
|
python -m http.server 3000
|
|||
|
|
```
|
|||
|
|
5. **访问前端**：http://localhost:3000
|
|||
|
|
|
|||
|
|
## 调试建议
|
|||
|
|
|
|||
|
|
1. 查看 graph-rag-agent 的启动日志，看是否有错误
|
|||
|
|
2. 确保所有依赖都已正确安装
|
|||
|
|
3. 检查防火墙设置是否阻止了 8000 端口
|
|||
|
|
4. 如果在 WSL 中运行，确保 Windows 防火墙允许 WSL 访问
|