> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phanedge.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 故障排查

> 排查 GLM 接入中的 web_search、渠道不可用、兼容入口与响应字段问题。

## 400 `invalid_tool`

### 现象

```json theme={null}
{
  "error": {
    "code": "invalid_tool",
    "message": "web_search tool requires web_search object"
  }
}
```

### 原因

你只传了：

```json theme={null}
{ "type": "web_search" }
```

### 解决

补全原生 `web_search` 子对象，至少包含：

```json theme={null}
{
  "type": "web_search",
  "web_search": {
    "enable": true
  }
}
```

完整推荐写法见 [联网搜索](/glm/web-search)。

## 返回 200，但时效信息不可信

### 常见表现

* 问“今天日期”却回答旧日期
* 问“最近新闻”却给出更早年份的信息

### 原因

模型未必会在所有问题上稳定自主搜索；只传 `enable: true` 时，强时效问题可能仍然不够稳。

### 解决

对日期、天气、新闻、近期公告这类问题：

1. 显式传 `search_query`
2. 开启 `search_result: true`
3. 读取顶层 `web_search` 结果，核对来源与时间

## 响应里没有顶层 `web_search`

先检查这几个点：

1. 请求里是否传了 `search_result: true`
2. 本次回答是否真的触发了搜索
3. 上游是否返回了搜索证据

如果你显式传了 `search_query`，仍然完全没有 `web_search`，建议记录：

* `request_id`
* 模型名
* 完整请求体（脱敏后）
* 返回的 `choices[0].message.content`

## 500 / 503 上游不可用

### 常见错误

* `upstream_server_error`
* `MODEL_GROUP_ALL_UNAVAILABLE`

### 处理建议

1. 先用 `GET /v1/models` 确认当前 Token 和模型可见性
2. 重试一次最小普通文本请求，确认是否只有 `web_search` 失败
3. 记录 `request_id`，必要时关联平台日志排查

## 该用哪个入口

| 场景                              | 推荐入口                   |
| ------------------------------- | ---------------------- |
| 普通文本、OpenAI SDK、GLM web\_search | `/v1/chat/completions` |
| Anthropic SDK、Messages 协议客户端    | `/v1/messages`         |

## 最佳实践

1. **强时效任务显式传 `search_query`**
2. **依赖来源证据时读取顶层 `web_search`**
3. **只在确有需要时使用 `/v1/messages`**
4. **保留 `request_id` 便于平台排障**