AI陪伴指南

酒馆常见报错：连接失败、403 地区不支持、429 限额怎么办（2026）

2026 年酒馆 SillyTavern 常见报错汇总：连接失败、Gemini 与 Claude 地区不支持、401、402、429、空回复和手机连电脑 Forbidden，按报错原文给出原因和处理办法。

作者：苏苏 发布： 最后更新： 栏目：酒馆

结论先说：酒馆的报错九成能按三类分开处理——网络类（连接失败、超时、地区不支持）、Key 类（401、403）、额度类（402、429）。第一步永远是去运行酒馆的终端窗口看完整报错原文，而不是只看浏览器弹出的一句提示。接 Gemini、Claude 的网络类问题，核心都是：运行酒馆的那台设备有没有走日本、新加坡等受支持地区的出口。

本文默认你已经装好酒馆并接过一次 API。还没接的话，先看 Gemini、Claude 或 DeepSeek 的接入教程。

前置条件

先找到报错原文

酒馆分两部分：浏览器里的界面，和后台的 Node 服务端。启动酒馆时弹出的那个终端窗口（Windows 命令行、macOS 终端、安卓 Termux）就是服务端，所有 API 请求都从这里发出，报错也打印在这里。浏览器右上角的弹窗只是概括，排查时以终端为准。

网络环境

不同 API 对网络的要求完全不同：

  • DeepSeek：国内直连，不需要加速器。
  • Gemini：支持地区约 230 个，不含中国大陆、香港、澳门。
  • Claude：支持地区约 185 个，不含中国大陆、香港、澳门，2026-11-12 起新版地区政策生效。

接 Gemini、Claude 时，运行酒馆的设备要有日本、新加坡、韩国或美国的出口，加速器手动选定地区，不要用自动选择，也不要选香港。该服务官方支持地区不含中国大陆，账号地区与网络出口不一致可能触发风控或封号，请自行评估风险。

报错速查表

报错原文或现象类别最可能原因处理
浏览器打不开 localhost:8000本地酒馆服务端没在运行重新运行启动脚本，终端窗口不要关
fetch failed、ETIMEDOUT、ECONNRESET网络服务端连不上 API见下文「连接失败」
400 FAILED_PRECONDITION：User location is not supported地区Gemini 判定出口不在支持地区换日本、新加坡节点，切全局模式
403 Country, region, or territory not supported地区OpenAI 判定出口不在支持地区同上
401、API key not validKeyKey 填错、已删除、带了空格重新复制 Key
403 PERMISSION_DENIED / permission_errorKeyKey 无权限、项目受限、Key 被报泄露回后台检查 Key 与项目状态
402余额Gemini 预付余额或 DeepSeek 余额用完充值
400 Your credit balance is too low余额Claude 余额不足（不是 402）到 Console 充值
429额度太频繁或当日额度用完等待，或第二天再试
500、503、529服务端模型方服务器繁忙稍后重试
no candidate、Candidate text empty设置Gemini 空回复见下文「空回复」
Forbidden: Connection attempt from …本地手机访问电脑酒馆被白名单拦截见下文「手机连不上电脑」

各家错误码来自官方文档：Gemini 排错指南、Claude 错误码、DeepSeek 错误码。

连接失败、超时怎么办？

结论：多半是酒馆服务端没走海外出口。

这类报错出现在终端里，常见 fetch failed、ETIMEDOUT、ECONNRESET 字样，浏览器只提示连接失败。原因是酒馆服务端默认不走系统层面的网络转发设置，维护者在 GitHub issue #3234 里确认过这一点。所以常见的情况是：浏览器能打开 AI Studio，酒馆却连不上 Gemini。

按顺序处理：

  1. 加速器手动选日本或新加坡节点，切到全局模式，然后重启酒馆再点 Connect。
  2. 仍不行，而你的加速器客户端提供本地端口，就在酒馆根目录的 config.yaml 里开启 requestProxy，填 http://127.0.0.1:端口号，重启生效。具体写法见 酒馆接 Gemini。
  3. 接 DeepSeek 时出现超时，先关掉全局模式改回智能分流，DeepSeek 是国内直连的。

官方 config.yaml 文档还有一个 enableCorsProxy 选项，它是给部分扩展用的，内置的 API 连接不需要开，和上面的 requestProxy 不是一回事。

403 / 地区不支持怎么办？

结论：换受支持地区的节点，并确认是服务端在走这个出口。

Gemini 返回的是 400 FAILED_PRECONDITION，文案为「User location is not supported for the API use」；OpenAI 返回 403「Country, region, or territory not supported」。Claude 在不支持地区下的具体返回以实际报错为准。处理顺序：

  1. 确认节点不是香港、澳门。
  2. 按上一节确认服务端走了海外出口。
  3. 仍报错就换同地区的另一个节点。Google 对部分机房 IP 的判断和公开 IP 库不一致，开发者论坛里有日本、美国 IP 也被误判的例子。
  4. Gemini 用户还要检查 Google Payments 里有没有不支持地区的付款资料。

Gemini 不带 Key 时返回的 403「Method doesn’t allow unregistered callers」不是地区问题，只是没填 Key。

429 限额怎么办？

结论：429 不是 Key 坏了，是请求太快或额度用完。

  • Gemini 免费层：每分钟和每天都有上限，按项目计算，在 AI Studio 的 Rate limit 页查看。每日额度按太平洋时间午夜重置，冬令时约为北京时间 16:00。同项目多建 Key 不会多出额度。
  • Claude：rate_limit_error 表示超出速率，或达到当前 Tier 的月支出上限，在 Console 的 Limits 页查看。
  • DeepSeek：请求太快或超出并发、QPS 限制时返回 429，放慢发送即可。

酒馆里频繁点重新生成（Swipe）、开着自动续写，都会让请求次数翻倍，免费层很容易撞上限。官方建议对 429 做退避重试，对 400、402、403 不要反复重试。

余额不足和 Key 错误

401 / API key not valid：Key 填错、多了空格或已被删除。回后台重新复制。Key 泄露后要立刻删除重建，不要把含 Key 的截图发到群里。

402：Gemini 预付余额或 DeepSeek 余额用完，充值即可。

Claude 的 credit balance is too low：Anthropic 对余额不足返回 400 而不是 402。余额明明充足仍报这个错，可能是账号或组织被限制，查邮箱通知。

空回复、被拦截怎么办？

Gemini 返回「no candidate」「Candidate text empty」时，有第三方读过酒馆 1.19.0 源码后建议：用 Gemini 3.8 Flash 时推理强度不要设 Minimum、关闭预填，并调大 Max Response Length。Claude 4.6 及之后的模型不支持预填，从别处导入的旧预设报 prefill 相关错误时，把预设里的 Assistant Prefill 清空。

PROHIBITED_CONTENT 这类拦截是模型方内置规则，Google 官方文档写明开发者无法调整。酒馆不改变模型的内容规则，本站不提供任何「破限」预设。

状态灯红、手机连不上电脑

状态灯红但能回复：按 官方 Chat Completions 文档，可以勾选 Bypass API status check 隐藏警告。它只隐藏警告，修不了 Key、权限和额度问题。用 Custom 方式接时，地址末尾不要加 /chat/completions。

手机打开电脑上的酒馆显示 Forbidden：按 官方远程连接文档，在根目录 config.yaml 把 listen 设为 true，在 whitelist 里加入 192.168.0.0/16 等局域网网段，保留 127.0.0.1 和 ::1，重启后用「电脑局域网 IP:8000」访问。改的是根目录的 config.yaml，不是 default/ 里的那份；根目录如果有 whitelist.txt，它会覆盖 config.yaml 的设置。

中转和反代能解决报错吗？

能让报错消失，但本站不推荐。第三方中转、反代意味着你的 Key 和全部对话都经过一台不知道谁在运营的服务器，可能被记录、被盗用，也可能违反模型方的服务条款。酒馆仓库还有 issue 记录过导出预设时会带出自己填的反代地址和密码。

常见问题

报错看哪里？ 看运行酒馆的终端窗口，那里有完整原文。

User location is not supported 是封号吗？ 不是，是出口地区不对，换日本、新加坡等节点。

浏览器能开 Google，酒馆却超时？ 服务端默认不走系统网络设置，切全局模式或配置 requestProxy。

429 是 Key 坏了吗？ 不是，是太频繁或额度用完。

状态灯红但能回复？ 勾选 Bypass API status check 即可，它只隐藏警告。

手机访问显示 Forbidden？ 改 config.yaml 的 listen 与 whitelist 后重启。

内容被拦截能改设置解决吗？ 不能，那是模型方的规则。

参考来源

常见问题

酒馆报错应该看哪里？

先看运行酒馆的那个黑色终端窗口（Windows 的命令行、macOS 终端或 Termux），那里会打印 API 返回的完整报错；浏览器右上角弹出的提示往往只有一句概括。

User location is not supported 是账号被封了吗？

不是。这是 Gemini 返回的地区错误，说明发出请求的设备出口不在支持地区。换到日本、新加坡、韩国或美国节点即可，香港不在支持名单内。

浏览器能打开 Google，酒馆却连接超时，为什么？

酒馆的 API 请求由 Node 服务端发出，默认不走系统层面的网络转发设置。浏览器走了海外出口，服务端可能仍是国内直连。把加速器切到全局模式，或在 config.yaml 里配置 requestProxy。

429 是不是 Key 坏了？

不是。429 表示请求太频繁或额度用完：Gemini 免费层每分钟和每天都有上限，Claude 有速率和支出上限，DeepSeek 在超出并发时也返回 429。等一会儿或第二天再试，Key 本身没问题。

状态灯是红的但 Test Message 能回复，要紧吗？

不要紧。可以勾选 Bypass API status check 隐藏状态警告。注意它只隐藏警告，不能修复 Key 错误、权限或额度问题。

手机浏览器打开电脑上的酒馆显示 Forbidden 怎么办？

这是白名单拦截。在酒馆根目录的 config.yaml 里把 listen 设为 true，并在 whitelist 里加入 192.168.0.0/16 这类局域网网段，重启酒馆后再用电脑的局域网 IP 加 8000 端口访问。

报错提示内容被拦截，能改设置解决吗？

不能。像 Gemini 的 PROHIBITED_CONTENT 是模型方内置的规则拦截，酒馆不改变模型的内容规则，本站也不提供任何「破限」方法。

#SillyTavern#酒馆#报错#403#429#连接失败
苏苏

AI 陪伴重度用户，2023 年起玩 Character.AI 和酒馆，负责本站教程的实测与更新。

相关阅读