酒馆报错排查指南

酒馆在使用过程中，常常会出现各种问题，为了帮助大家逐步成长为“酒馆”高手，这里有一份问题排查的建议流程。

这不仅能帮你快速定位问题，更能锻炼独立解决问题的能力——这在使用“酒馆”的过程中是必备的宝贵技能哦！

一、报错的建议四步处理步骤

当遇到报错时，我们倡议大家尝试按以下“四步法”来寻宝：

1，【截图存证】：第一时间截取完整的报错画面。

2，【深入后台】：立即打开酒馆的后台（如 CMD、Termux 或云端日志），找到并复制相关的错误信息 （通常在日志的末尾） 。（关注 E、Error 等字样）

第三部分有如何查看日志的指引。

3，【AI 军师】：将后台的错误信息，“喂”给 AI 助手（如豆包、Deepseek 等）。目前，超过 80% 的常见问题，AI 都能给出相当精准的诊断。

你也可以使用 当贝AI 在线进行提问，地址是 https://ai.dangbei.com ，免登录，可用 Deepseek、豆包模型。

向 AI 提问的技巧：AI 可能并不能准确的理解酒馆是什么（受限于它的知识库新旧程度），所以你可以打开 AI 的联网搜索，或者不指出是酒馆的问题，而是聚焦于和 AI 对话的问题。

例如：

我在通过API调用和AI模型对话的时候，遇到了下方的报错，请问这是什么原因导致的？有什么解决方案吗？
【粘贴上你的错误信息】

4，【带题提问】：如果 AI 也束手无策，请带着 ① 报错截图 + ② 后台日志 + ③AI 的分析回答，这三样法宝，再去找可以答疑的老师进行提问。这样大家就能迅速理解你的困境，对症下药！

注意

如果你是通过第三方API站点购买的API，报错为API相关，直接去找售后提问错误原因；

如果你是使用公益站，报错为API相关，你必须要有 免费服务不可能长时间保证稳定 的心理预期。（基本也问不到解决方案）

二、一点心得分享：

“酒馆”是一款自由度极高的工具，也因此 在使用中遇到各种小状况是 家常便饭。

学会基础的排查方法，就像是拿到了探索这个奇妙世界的地图和指南针。

我非常鼓励你自己动手尝试，享受从发现问题到解决问题的乐趣。

如果每次遇到问题都直接去找人询问，而不做任何初步探索，那么不仅解决效率低，也容易让自己变得烦躁。

以上。

常见错误类：

• 大部分问题是 API 问题，网络问题就尝试开/关 🪜，以及更换节点（推荐美国、新加坡和日本）；
• 还有一部分是 Settings Not Saved 的报错，如果你是云酒馆，挂 🪜 然后刷新网页试试，如果你是安卓酒馆，把你的 Termux 挂小窗；
• 导入文件失败，比如正则、预设导入失败……你可能导入了错误的文件，尤其是报错 Invaild file 的话，仔细检查你的文件是不是选错了；
• 内容没有通过审核相关的报错，尝试重新生成回复；
• 出现“我只是一个 AI 大模型，无法回答……相关问题”，尝试重新生成回复，或更换破限力度更强的预设；
• 出现截断、空回复，主要看有没有内容出现，出现一半是截断，空回复，但是点小铅笔有内容也是截断，可以试着调高预设中的“最大回复长度”，但是不要超过 65536（特指 gemini-2.5-pro 模型，Deepseek的话不超过8192），如果还不行就是截断了，尝试开启预设中的抗截断或者防空回提示词（若有）。

三、各平台查看日志的方法。

1，安卓本地酒馆

这个最简单，在你的 Termux 中。

长按选择日志中最后部分 一看就像是报错 的那些内容，然后点复制或者 Copy。

注意 Error 相关字样，以及 403、404、429、500 等报错的代码，以及 ETIMEOUT 等错误信息。

去找 AI 询问，例如当贝 AI：https://ai.dangbei.com

请注意，有相当一部分报错问题，来自于你的 Termux 掉后台，所以你可以试着将 Termux 挂小窗，这是最稳定的保持 Termux 运行的方案。

2，Win/Mac 本地酒馆

这个也简单，日志信息会实时显示在你的 CMD 窗口中。（Mac 在终端窗口中）

选择日志中最后部分一看就像是报错的那些内容，复制。

注意 Error 相关字样，以及 403、404、429、500 等报错的代码，以及 ETIMEOUT 等错误信息。

去找 AI 询问，例如当贝 AI：https://ai.dangbei.com

3，VPS 云酒馆

这里以基于 1Panel 启动的云酒馆为例。

① 打开你的 1Panel

② 找到你的 网站 → 运行环境 → Node.js，已经可以看到你的酒馆项目了

③ 找到日志部分，点击查看

④ 然后就能看到日志了。

选择日志中最后部分（滑到最下面）一看就像是报错的那些内容，复制。

注意 Error 相关字样，以及 403、404、429、500 等报错的代码，以及 ETIMEOUT 等错误信息。

去找 AI 询问，例如当贝 AI：https://ai.dangbei.com

---

教程结束。