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 一直处于创建状态

• 原因：服务器负载过高
• 解决方案：按照教程更换服务器地区