# 错误码与故障排除

## 常见错误

| 错误类型 | 可能原因 | 解决方案 |
|---------|---------|---------|
| 认证失败 | API密钥无效或未配置 | 检查环境变量或.env文件 |
| 参数错误 | 参数格式不正确 | 确保使用 `key=value` 格式 |
| 无结果 | 企业ID不存在或参数值错误 | 先用模糊搜索确认企业ID |
| 工具未找到 | 查询意图描述不清晰 | 使用更具体的描述词 |

## 服务端状态码

调用工具时，服务端可能返回以下状态码：

| 状态码 | 说明 | 处理建议 |
|-------|------|---------|
| 231 | API Key无效 | 检查并更新API密钥配置 |
| 232 | 工具已下架/权限不足 | 联系管理员确认权限或使用其他工具 |
| 233 | 工具不存在 | 重新使用 find_tool 查找正确的工具ID |
| 234 | 参数校验失败 | 检查参数格式和取值范围 |
| 235 | 调用次数不足 | 联系管理员增加配额 |
| 237 | 数据为空 | 确认查询条件是否正确，或尝试网络搜索 |

## 数据查询回退机制

当通过本 skill 无法查询到企业数据时（如返回状态码 237 或查询结果为空），可使用网络搜索工具作为回退方案：

1. **触发条件**：企业信息查询无结果、数据为空、或企业不在数据库覆盖范围
2. **回退方式**：使用 WebSearch 工具搜索企业相关信息
3. **搜索建议**：使用企业全称 + 关键词（如"工商信息"、"股权结构"等）进行搜索