wl
3ad6eee0d9
- 配置 Docker Compose 多服务编排 - 实现 Chatwoot + Agent 集成 - 配置 Strapi MCP 知识库 - 支持 7 种语言的 FAQ 系统 - 实现 LangGraph AI 工作流 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
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. 是否需要查看具体的容器日志以确认错误？
|