Ai_GirlFriend/xuniYou/PHP超时问题解决.md

# PHP 服务器超时问题解决

## 🔍 问题诊断结果

### 发现的问题

1. **多个 PHP 进程同时运行**
   - 发现 2 个 PHP 进程（PID: 14076, 22776）
   - 都在监听 30100 端口
   - 导致端口冲突和资源竞争

2. **大量半关闭连接**
   - 多个 `CLOSE_WAIT` 状态的连接
   - 多个 `FIN_WAIT_2` 状态的连接
   - 说明连接没有正常关闭，资源耗尽

3. **Python 也有多个进程**
   - 发现 2 个 Python 进程（PID: 12040, 19024）
   - 可能是之前启动失败后没有清理

### 根本原因

**重复启动服务导致的端口冲突和资源耗尽：**
- 多次运行启动脚本
- 旧进程没有正确关闭
- 新进程无法正常工作
- 连接堆积导致超时

## ✅ 已执行的修复

已经停止了所有旧的进程：
```powershell
Stop-Process -Id 14076,22776 -Force  # PHP 进程
Stop-Process -Id 12040,19024 -Force  # Python 进程
```

端口已完全释放，可以重新启动服务。

## 🚀 正确的启动流程

### 方法 1：使用启动脚本（推荐）

**启动脚本会自动清理旧进程：**

1. 双击运行 `启动项目.bat`
2. 脚本会自动：
   - 检查并终止占用端口的旧进程
   - 等待端口释放
   - 启动 PHP 服务器（30100）
   - 启动 Python 服务器（30101）

### 方法 2：手动启动

**如果需要手动启动：**

1. **先清理旧进程：**
```powershell
# 查找占用端口的进程
netstat -ano | Select-String ":30100"
netstat -ano | Select-String ":30101"

# 停止进程（替换为实际的 PID）
Stop-Process -Id <PID> -Force
```

2. **启动 PHP 服务器：**
```cmd
cd xunifriend_RaeeC\public
php -S 0.0.0.0:30100 router.php
```

3. **启动 Python 服务器：**
```cmd
python -m uvicorn lover.main:app --host 0.0.0.0 --port 30101 --reload
```

## 🔧 避免问题的最佳实践

### 1. 启动前检查

**每次启动前先检查端口：**
```powershell
netstat -ano | Select-String ":30100"
netstat -ano | Select-String ":30101"
```

如果有输出，说明端口被占用，需要先停止旧进程。

### 2. 正确停止服务

**不要直接关闭窗口，而是：**
- 在服务器窗口中按 `Ctrl+C`
- 等待服务正常退出
- 或者使用任务管理器结束进程

### 3. 使用启动脚本

**启动脚本的优势：**
- 自动检测并清理旧进程
- 自动等待端口释放
- 在独立窗口中运行，便于查看日志
- 出错时容易定位问题

### 4. 定期清理

**如果遇到问题，可以手动清理：**

```powershell
# 停止所有 PHP 进程
Get-Process | Where-Object {$_.ProcessName -eq "php"} | Stop-Process -Force

# 停止所有 Python 进程（注意：会停止所有 Python 程序）
Get-Process | Where-Object {$_.ProcessName -eq "python"} | Stop-Process -Force
```

## 📊 验证服务是否正常

### 1. 检查进程

```powershell
# 应该只有 1 个 PHP 进程
Get-Process | Where-Object {$_.ProcessName -eq "php"}

# 应该只有 1 个 Python 进程（或 2 个，如果有其他 Python 程序）
Get-Process | Where-Object {$_.ProcessName -eq "python"}
```

### 2. 检查端口

```powershell
# 应该只有 1 个 LISTENING 状态
netstat -ano | Select-String ":30100" | Select-String "LISTENING"
netstat -ano | Select-String ":30101" | Select-String "LISTENING"
```

### 3. 测试访问

**PHP 服务器：**
```
http://127.0.0.1:30100/test_api.php
```

**Python 服务器：**
```
http://127.0.0.1:30101/docs
```

## 🐛 常见问题

### 问题 1：启动脚本无法清理旧进程

**症状：**
- 启动脚本运行后还是有多个进程
- 端口还是被占用

**解决：**
手动停止所有进程：
```powershell
Get-Process | Where-Object {$_.ProcessName -eq "php"} | Stop-Process -Force
Get-Process | Where-Object {$_.ProcessName -eq "python"} | Stop-Process -Force
```

### 问题 2：PHP 服务器启动后立即退出

**症状：**
- PHP 窗口一闪而过
- 端口没有被监听

**可能原因：**
- PHP 路径配置错误
- router.php 文件不存在
- 端口被其他程序占用

**解决：**
1. 检查 `启动项目.bat` 中的 `PHP_PATH` 配置
2. 确认 `xunifriend_RaeeC\public\router.php` 存在
3. 尝试手动启动查看错误信息

### 问题 3：Python 服务器无法连接 PHP

**症状：**
- Python 日志显示 "请求超时"
- PHP 服务器正常运行

**可能原因：**
- PHP 服务器响应慢
- 防火墙阻止本地连接
- PHP 代码有错误

**解决：**
1. 在浏览器中测试 PHP 接口：
   ```
   http://127.0.0.1:30100/api/user_basic/get_user_basic
   ```
2. 查看 PHP 服务器窗口的错误日志
3. 检查 PHP 代码是否有语法错误

## 📝 下一步

现在所有旧进程已清理，请：

1. **重新启动服务：**
   - 双击运行 `启动项目.bat`
   - 或者手动启动 PHP 和 Python 服务器

2. **验证服务正常：**
   - 访问 http://127.0.0.1:30100
   - 访问 http://127.0.0.1:30101/docs

3. **测试语音通话：**
   - 打开 App
   - 进入语音通话页面
   - 测试功能

4. **观察日志：**
   - 不应该再有 "请求超时" 错误
   - 应该能正常获取用户信息

---

**问题：** PHP 服务器超时  
**原因：** 多个进程同时运行，端口冲突，连接堆积  
**解决：** 停止所有旧进程，重新启动  
**状态：** ✅ 已清理，可以重新启动