kita / notes
← 回到全部笔记

事件日期 阅读约 3 分钟

AstrBot 4.29.4 升级后的两个遗留故障:容器退回 host 网络失联与 WebChat 搜索 <ref> 标签泄漏

发布于

本文目录(2 节)
  1. 1. 升级后 NapCat 狂报 getaddrinfo EAI_AGAIN astrbot:用 docker commit 保住 4.29.4 并迁回双网桥
  2. 2. 为什么普通 QQ 没漏标签,WebChat 里却冒出了 8 个 <ref>?

11 月初把服务器上的 AstrBot 容器升级到 4.29.4 后,虽然面板能打开,但紧接着在 11 月 3 日和 11 月 7 日各处理了一起和架构边界有关的线上故障:一次是容器网络模式偏离 docker-compose.yml 导致 QQ 链路和 ReMe 记忆服务双双断连,另一次是 WebChat / App 端聊天正文里冒出了成串的 <ref>...</ref> 内部引用标签。

1. 升级后 NapCat 狂报 getaddrinfo EAI_AGAIN astrbot:用 docker commit 保住 4.29.4 并迁回双网桥

11 月 3 日更新完 AstrBot 后,机器人突然在 QQ 上彻底失联。看 NapCat 容器日志,满屏都在刷:

getaddrinfo EAI_AGAIN astrbot

同时机器人内部的 ReMe 记忆客户端也在报 ClientConnectorDNSError。

跑 docker inspect astrbot 一看就明白了:升级过程创建的这个 4.29.4 容器处于 host 网络模式,而原本 /root/astrbot/docker-compose.yml 声明的是让 astrbot 同时加入 astrbot_default(供 NapCat 通过 ws://astrbot:6195/ws 反向连接)和外部网络 kafu-reme-live-20261022(连接记忆服务)。一旦 astrbot 跑进了宿主机网络,留在 astrbot_default 桥接网里的 NapCat 自然解析不出 astrbot 这个容器主机名。

这里有一个不能直接 docker compose up -d --force-recreate 的坑(10 月 29 日我们已经栽过一次):

  • 磁盘上的基础镜像 soulter/astrbot:latest 还是旧版;
  • 更重要的是,容器内部通过面板升级后的 4.29.4 代码以及 37 个插件在容器层里 pip 装好的依赖(包括 Playwright、yt-dlp 等),全都只在当前运行容器的可写层里。如果直接拿旧镜像 recreate,不仅版本会退回去,还会触发全部插件重装依赖导致断服十来分钟。

所以稳妥的恢复步骤是:

  1. 先对 data_v4.db 做 SQLite 在线备份,并把当前 4.29.4 容器的文件系统用 docker commit 固化为本地镜像 local/astrbot-recovery:20261103t065115z(同时把旧容器改名为 astrbot-before-network-20261103t065115z 留作秒级回滚锚点);
  2. 新增 /root/astrbot/docker-compose.override.yml,将 image 指向刚提交的 local/astrbot-recovery:20261103t065115z,宿主机 6195 端口维持只绑 127.0.0.1:6195:6195;
  3. 按原 compose 声明拉起新容器,使其重新接入 astrbot_default 与 kafu-reme-live-20261022 两个网络。

容器拉起后,NapCat 日志当场打印 OneBot 适配器已连接(TCP 6195 ESTABLISHED),ReMe 健康检查返回 ready=true, failed=0,全程零依赖重装、零版本回退。

2. 为什么普通 QQ 没漏标签,WebChat 里却冒出了 8 个 <ref>?

11 月 7 日下午,在 WebChat / App 端查看一条带联网搜索的回复(platform_message_history.id=102255)时,发现正文里夹杂着 8 处 <ref>...</ref> 原始引用标记。

去查 astrbot_plugin_kafu_conversation/output_guard.py,原因有两层:

  • 第一层是 output_guard.py 之前只拦截了 <think>、<thinking>、<analysis>、<reasoning> 和 <comtext>,正则表达式里还没把搜索引用标签 <ref>...</ref> 加进去;
  • 第二层才是关键:即便只在插件的 on_decorating_result 钩子里补上 <ref> 过滤,WebChat 照样会漏!因为 AstrBot 的 WebChat、LiveChat 和 OpenAPI WebSocket 走的是独立的 dashboard/services/chat_service.py(通过 BotMessageAccumulator 累积流式分片、直接推送给前端并写入 platform_message_history),根本不经过普通消息平台的 on_decorating_result 插件钩子。

搞清楚这两条分叉路径后,修法就必须两头堵:

  1. 插件侧(output_guard.py):把 <ref>...</ref> 纳入标签剥离规则,支持跨多个 Plain 消息段合并清理,同时依然保护 Markdown 代码块(```)、行内代码与引用块里的合法示例文本;
  2. Dashboard 核心侧(BotMessageAccumulator):在流式/非流式共用的累积器里加上跨 chunk 的状态机清洗器——用原始未清洗文本去解析搜索引用索引、生成结构化的 refs 来源元数据卡片,而用剥离 <ref> 后的干净文本做实时 SSE 推送与数据库落盘。这样前端底部的参考来源卡片一个不少,正文里又不会出现刺眼的 <ref> 源码;
  3. 清洗存量历史:备份 data_v4_before_history_cleanup.sqlite 后,把 platform_message_history.id=102255 及对应会话历史里的 8 处 <ref> 包装洗干净(保留其 7 条结构化来源元数据),并将打好补丁的容器再次固化为 local/astrbot-ref-clean:20261107。

← 返回全部手记