160 lines
3.8 KiB
Markdown
160 lines
3.8 KiB
Markdown
|
# MCP 容器重启问题诊断报告
|
|||
|
|
|
|||
|
|
## 问题概述
|
|||
|
|
|
|||
|
|
MCP 服务容器（strapi_mcp, order_mcp, aftersale_mcp, product_mcp）一直在重启。
|
|||
|
|
|
|||
|
|
## 容器架构
|
|||
|
|
|
|||
|
|
```mermaid
|
|||
|
|
graph TB
|
|||
|
|
subgraph "MCP Servers"
|
|||
|
|
A[strapi_mcp:8001]
|
|||
|
|
B[order_mcp:8002]
|
|||
|
|
C[aftersale_mcp:8003]
|
|||
|
|
D[product_mcp:8004]
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
subgraph "外部依赖"
|
|||
|
|
E[Strapi CMS<br/>49.234.16.160:1337]
|
|||
|
|
F[Hyperf API<br/>apicn.qa1.gaia888.com]
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
subgraph "内部依赖"
|
|||
|
|
G[agent:8005]
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
A --> E
|
|||
|
|
B --> F
|
|||
|
|
C --> F
|
|||
|
|
D --> F
|
|||
|
|
G --> A
|
|||
|
|
G --> B
|
|||
|
|
G --> C
|
|||
|
|
G --> D
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 诊断结果
|
|||
|
|
|
|||
|
|
### 1. 环境变量配置问题（主要原因）
|
|||
|
|
|
|||
|
|
在 [`.env`](../.env) 文件中发现以下问题：
|
|||
|
|
|
|||
|
|
| 环境变量 | 当前值 | 问题 |
|
|||
|
|
|---------|--------|------|
|
|||
|
|
| `STRAPI_API_TOKEN` | `""` (空) | strapi_mcp 无法认证 |
|
|||
|
|
| `HYPERF_API_TOKEN` | `""` (空) | order_mcp, aftersale_mcp, product_mcp 无法认证 |
|
|||
|
|
| `REDIS_PASSWORD` | `""` (空) | Redis 健康检查可能失败 |
|
|||
|
|
|
|||
|
|
### 2. 客户端初始化问题
|
|||
|
|
|
|||
|
|
在 [`mcp_servers/shared/strapi_client.py`](../mcp_servers/shared/strapi_client.py) 和 [`mcp_servers/shared/hyperf_client.py`](../mcp_servers/shared/hyperf_client.py) 中：
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
class StrapiSettings(BaseSettings):
|
|||
|
|
strapi_api_url: str
|
|||
|
|
strapi_api_token: str # 必需字段，但值为空字符串
|
|||
|
|
|
|||
|
|
settings = StrapiSettings() # 模块加载时执行
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
当 `api_token` 为空时：
|
|||
|
|
- 不会立即抛出异常（空字符串是有效的 str 值）
|
|||
|
|
- 但所有 API 请求都会因认证失败而报错
|
|||
|
|
- 可能导致服务启动失败或运行时崩溃
|
|||
|
|
|
|||
|
|
### 3. 健康检查配置
|
|||
|
|
|
|||
|
|
在 [`docker-compose.yml`](../docker-compose.yml) 中，所有 MCP 服务都配置了健康检查：
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
healthcheck:
|
|||
|
|
test: ["CMD", "curl", "-f", "http://localhost:8001/health"]
|
|||
|
|
interval: 30s
|
|||
|
|
timeout: 10s
|
|||
|
|
start-period: 5s
|
|||
|
|
retries: 3
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
如果服务启动失败或 `/health` 端点不可用，健康检查会失败，Docker 可能会重启容器。
|
|||
|
|
|
|||
|
|
### 4. 服务启动流程
|
|||
|
|
|
|||
|
|
MCP 服务的启动流程：
|
|||
|
|
|
|||
|
|
```mermaid
|
|||
|
|
sequenceDiagram
|
|||
|
|
participant DC as Docker
|
|||
|
|
participant SVR as Server.py
|
|||
|
|
participant ENV as Settings
|
|||
|
|
participant CLI as HTTP Client
|
|||
|
|
participant API as External API
|
|||
|
|
|
|||
|
|
DC->>SVR: python server.py
|
|||
|
|
SVR->>ENV: 加载环境变量
|
|||
|
|
ENV-->>SVR: api_token = ""
|
|||
|
|
SVR->>CLI: 初始化客户端
|
|||
|
|
CLI->>API: 首次请求（如果需要）
|
|||
|
|
API-->>CLI: 401 Unauthorized
|
|||
|
|
CLI-->>SVR: 抛出异常
|
|||
|
|
SVR-->>DC: 启动失败
|
|||
|
|
DC->>DC: 重启容器
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 可能的错误信息
|
|||
|
|
|
|||
|
|
基于代码分析，容器日志中可能出现以下错误：
|
|||
|
|
|
|||
|
|
1. **认证失败**:
|
|||
|
|
```
|
|||
|
|
httpx.HTTPStatusError: 401 Unauthorized
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. **连接错误**:
|
|||
|
|
```
|
|||
|
|
httpx.ConnectError: Connection refused
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. **超时错误**:
|
|||
|
|
```
|
|||
|
|
httpx.TimeoutException
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
4. **健康检查失败**:
|
|||
|
|
```
|
|||
|
|
curl: (7) Failed to connect to localhost port 8001
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 影响范围
|
|||
|
|
|
|||
|
|
| 服务 | 影响原因 |
|
|||
|
|
|-----|---------|
|
|||
|
|
| `strapi_mcp` | `STRAPI_API_TOKEN` 为空 |
|
|||
|
|
| `order_mcp` | `HYPERF_API_TOKEN` 为空 |
|
|||
|
|
| `aftersale_mcp` | `HYPERF_API_TOKEN` 为空 |
|
|||
|
|
| `product_mcp` | `HYPERF_API_TOKEN` 为空 |
|
|||
|
|
| `agent` | 依赖所有 MCP 服务，可能间接受影响 |
|
|||
|
|
|
|||
|
|
## 修复建议
|
|||
|
|
|
|||
|
|
### 方案 1: 配置正确的 API Token（推荐）
|
|||
|
|
|
|||
|
|
1. 获取 Strapi API Token
|
|||
|
|
2. 获取 Hyperf API Token
|
|||
|
|
3. 更新 `.env` 文件
|
|||
|
|
|
|||
|
|
### 方案 2: 使服务在 Token 为空时也能启动（临时方案）
|
|||
|
|
|
|||
|
|
修改客户端代码，延迟初始化或添加容错逻辑。
|
|||
|
|
|
|||
|
|
### 方案 3: 禁用需要认证的服务
|
|||
|
|
|
|||
|
|
如果某些服务暂时不需要，可以将其从 docker-compose 中移除。
|
|||
|
|
|
|||
|
|
## 下一步行动
|
|||
|
|
|
|||
|
|
请确认：
|
|||
|
|
1. 是否有可用的 Strapi 和 Hyperf API Token？
|
|||
|
|
2. 是否需要修改代码以支持空 Token 的启动模式？
|
|||
|
|
3. 是否需要查看具体的容器日志以确认错误？
|