wiki/error.md

# 错误处理指南

## 提问须知
- 提供完整的报错日志是必要的，仅提供酒馆前端的红标提示无法进行有效诊断
- 报错日志应为您所部署的轮询项目的前端界面的系统日志部分，如果您不知道如何找到前端，请将您在酒馆插头部分所填写的链接末尾的/v1删掉，剩下的部分在浏览器内打开。
- 请确保包含以下信息：
  - 完整的错误信息
  - 相关的操作步骤

## 常见错误及解决方案
### Unauthorized 错误
- 原因：密码填写错误
- 解决方案：重新配置PASSWORD或者尝试默认密码123

### 403 错误
- api key已被谷歌封禁
- 解决方案：切换可用的api key

### 429 错误
可能原因：
1. Google API 配额限制
   - 当前配额限制：TPM 250K，TPD 1M
   - 实际可用次数可能远低于理论值，特别是在处理复杂楼层或复杂卡片时
   - 解决方案：
     - 增加 API Key 数量
     - 等待配额重置（北京时间下午三点）

2. 预设内容被标记
   - 解决方案：修改查重内容，特别是头尾部分

### 500/503 错误
- 原因：Google 服务器不稳定
- 解决方案：重新尝试

### 空响应问题
- 原因：Google 内容审核机制触发
- 解决方案：
  1. 切换角色卡进行验证
  2. 删除部分聊天记录
  3. 识别可能触发审核的内容并删除

### Claw 一直处于创建状态
- 原因：服务器负载过高
- 解决方案：按照教程更换服务器地区