Ai_GirlFriend/开发/2026年2月3日/PHP连接泄漏问题修复.md

# PHP 连接泄漏问题修复

## 问题描述

Python 后端调用 PHP 后端接口时出现超时错误：

```
HTTPConnectionPool(host='192.168.1.164', port=30100): Read timed out. (read timeout=5)
```

## 问题根源

通过 `netstat -ano | findstr :30100` 检查发现：
- PHP 服务（PID 23736 和 1416）有 30+ 个 `CLOSE_WAIT` 连接
- `CLOSE_WAIT` 状态表示：客户端已关闭连接，但服务器端未关闭
- 这是典型的**连接泄漏**问题

### 为什么会出现 CLOSE_WAIT？

1. **PHP 内置开发服务器的限制**
   - `php -S` 是单线程服务器，设计用于开发测试
   - 在处理大量并发请求时容易出现连接泄漏
   - 长时间运行会导致资源耗尽

2. **连接未正确关闭**
   - 客户端（Python）发送请求后关闭连接
   - 服务器端（PHP）没有正确关闭 socket
   - 连接进入 CLOSE_WAIT 状态并一直保持

3. **资源耗尽**
   - 大量 CLOSE_WAIT 连接占用系统资源
   - 导致新请求无法处理或响应缓慢
   - 最终导致超时错误

---

## 临时解决方案：重启 PHP 服务

### 方法 1：使用快速重启脚本（推荐）

双击运行 `restart_php_service.bat`：

```batch
restart_php_service.bat
```

这个脚本会：
1. 检查当前 PHP 服务状态
2. 停止所有 PHP 服务进程
3. 等待端口释放
4. 启动新的 PHP 服务

### 方法 2：手动重启

```bash
# 1. 查看当前 PHP 进程
netstat -ano | findstr :30100

# 2. 停止所有 PHP 进程（替换 PID）
taskkill /F /PID 23736
taskkill /F /PID 1416

# 3. 等待 2 秒

# 4. 启动新的 PHP 服务
cd C:\Users\Administrator\Desktop\Project\AI_GirlFriend\xunifriend_RaeeC\public
php -S 192.168.1.164:30100
```

### 验证服务已重启

```bash
# 检查服务状态
netstat -ano | findstr :30100

# 应该只看到 LISTENING 状态，没有 CLOSE_WAIT
```

---

## 监控连接状态

### 使用监控脚本

双击运行 `monitor_php_connections.bat`：

```batch
monitor_php_connections.bat
```

这个脚本会每 5 秒刷新一次，显示：
- 所有连接状态
- ESTABLISHED 连接数（正常活跃连接）
- CLOSE_WAIT 连接数（连接泄漏）
- TIME_WAIT 连接数（正常关闭中）

### 判断标准

- **正常**：CLOSE_WAIT < 10 个
- **注意**：CLOSE_WAIT 10-20 个（需要关注）
- **警告**：CLOSE_WAIT > 20 个（建议立即重启）

---

## 长期解决方案

### 方案 1：使用 Nginx + PHP-FPM（推荐）

PHP 内置服务器不适合生产环境，建议使用 Nginx + PHP-FPM。

#### 安装步骤

1. **下载 Nginx for Windows**
   - 访问：https://nginx.org/en/download.html
   - 下载稳定版（Stable version）

2. **下载 PHP（非线程安全版本）**
   - 访问：https://windows.php.net/download/
   - 下载 NTS (Non Thread Safe) 版本

3. **配置 PHP-FPM**

创建 `php-cgi.bat`：

```batch
@echo off
cd C:\php
php-cgi.exe -b 127.0.0.1:9000
```

4. **配置 Nginx**

编辑 `nginx.conf`：

```nginx
server {
    listen 30100;
    server_name 192.168.1.164;
    root C:/Users/Administrator/Desktop/Project/AI_GirlFriend/xunifriend_RaeeC/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}
```

5. **启动服务**

```batch
# 启动 PHP-FPM
start php-cgi.bat

# 启动 Nginx
cd C:\nginx
start nginx.exe
```

#### 优点

- 支持多进程，性能更好
- 连接管理更稳定
- 适合生产环境
- 不会出现连接泄漏

### 方案 2：定期自动重启 PHP 服务

如果暂时无法切换到 Nginx，可以设置定时任务自动重启 PHP 服务。

#### 创建定时任务

1. 打开"任务计划程序"（Task Scheduler）
2. 创建基本任务
3. 设置触发器：每 4 小时
4. 操作：启动程序 `restart_php_service.bat`

#### 或使用 Windows 计划任务命令

```batch
schtasks /create /tn "重启PHP服务" /tr "C:\path\to\restart_php_service.bat" /sc hourly /mo 4
```

### 方案 3：优化 Python 请求代码

在 `lover/deps.py` 中优化 HTTP 请求：

```python
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

# 创建带重试和连接池的 session
def get_http_session():
    session = requests.Session()
    
    # 配置重试策略
    retry = Retry(
        total=3,
        backoff_factor=0.3,
        status_forcelist=[500, 502, 503, 504]
    )
    
    # 配置连接池
    adapter = HTTPAdapter(
        max_retries=retry,
        pool_connections=10,
        pool_maxsize=20,
        pool_block=False
    )
    
    session.mount('http://', adapter)
    session.mount('https://', adapter)
    
    return session

# 使用 session
def _fetch_user_from_php(token: str) -> Optional[dict]:
    """通过 PHP/FastAdmin 接口获取用户信息。"""
    import logging
    logger = logging.getLogger(__name__)
    
    user_info_api = "http://192.168.1.164:30100/api/user_basic/get_user_basic"
    
    logger.info(f"用户中心调试 - 调用接口: {user_info_api}")
    
    try:
        session = get_http_session()
        resp = session.get(
            user_info_api,
            headers={
                "token": token,
                "Connection": "close"  # 明确关闭连接
            },
            timeout=10,  # 增加超时时间
        )
        logger.info(f"用户中心调试 - 响应状态码: {resp.status_code}")
        
        # 确保连接关闭
        resp.close()
        
    except requests.exceptions.Timeout:
        logger.error(f"用户中心调试 - 请求超时")
        raise HTTPException(
            status_code=status.HTTP_504_GATEWAY_TIMEOUT,
            detail="用户中心接口超时",
        )
    except Exception as exc:
        logger.error(f"用户中心调试 - 请求异常: {exc}")
        raise HTTPException(
            status_code=status.HTTP_502_BAD_GATEWAY,
            detail="用户中心接口不可用",
        ) from exc
    
    # ... 其余代码
```

---

## 预防措施

### 1. 监控连接状态

定期运行 `monitor_php_connections.bat` 检查连接状态。

### 2. 设置告警

当 CLOSE_WAIT 连接数超过阈值时，发送告警通知。

### 3. 日志记录

在 Python 代码中记录每次 PHP 调用的耗时：

```python
import time

start_time = time.time()
resp = requests.get(...)
elapsed_time = time.time() - start_time

logger.info(f"PHP 接口调用耗时: {elapsed_time:.2f}秒")

if elapsed_time > 3:
    logger.warning(f"PHP 接口响应缓慢: {elapsed_time:.2f}秒")
```

### 4. 健康检查

添加健康检查端点，定期检查 PHP 服务状态：

```python
@app.get("/health/php")
async def check_php_health():
    try:
        resp = requests.get(
            "http://192.168.1.164:30100/api/health",
            timeout=2
        )
        return {
            "status": "healthy" if resp.status_code == 200 else "unhealthy",
            "response_time": resp.elapsed.total_seconds()
        }
    except:
        return {"status": "down"}
```

---

## 常见问题

### Q1: 为什么会有两个 PHP 进程（PID 23736 和 1416）？

**A**: 可能是之前启动了多次 PHP 服务，导致有多个进程在监听同一端口。建议：
1. 停止所有 PHP 进程
2. 只启动一个 PHP 服务

### Q2: 重启后还是有 CLOSE_WAIT 怎么办？

**A**: 
1. 确认已停止所有旧的 PHP 进程
2. 检查是否有其他程序占用端口
3. 考虑更换端口或使用 Nginx

### Q3: 如何判断是 PHP 问题还是 Python 问题？

**A**: 
1. 使用 curl 直接测试 PHP 接口：
   ```bash
   curl -X GET "http://192.168.1.164:30100/api/user_basic/get_user_basic" -H "token: YOUR_TOKEN"
   ```
2. 如果 curl 正常，说明是 Python 客户端问题
3. 如果 curl 也慢，说明是 PHP 服务器问题

### Q4: 生产环境应该用什么？

**A**: 
- **不推荐**：`php -S`（仅用于开发）
- **推荐**：Nginx + PHP-FPM
- **备选**：Apache + mod_php

---

## 快速参考

### 检查连接状态
```bash
netstat -ano | findstr :30100
```

### 重启 PHP 服务
```bash
restart_php_service.bat
```

### 监控连接
```bash
monitor_php_connections.bat
```

### 停止所有服务
```bash
stop_all_services.bat
```

### 启动所有服务
```bash
start_all_services.bat
```

---

## 总结

1. **问题根源**：PHP 内置服务器连接泄漏
2. **临时方案**：定期重启 PHP 服务
3. **长期方案**：使用 Nginx + PHP-FPM
4. **监控措施**：使用监控脚本定期检查

建议尽快切换到 Nginx + PHP-FPM，彻底解决连接泄漏问题！