AstrBot 4.29.4 升级后的两个遗留故障:容器退回 host 网络失联与 WebChat 搜索 <ref> 标签泄漏
本文目录(2 节)
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,不仅版本会退回去,还会触发全部插件重装依赖导致断服十来分钟。
所以稳妥的恢复步骤是:
- 先对
data_v4.db做 SQLite 在线备份,并把当前4.29.4容器的文件系统用docker commit固化为本地镜像local/astrbot-recovery:20261103t065115z(同时把旧容器改名为astrbot-before-network-20261103t065115z留作秒级回滚锚点); - 新增
/root/astrbot/docker-compose.override.yml,将image指向刚提交的local/astrbot-recovery:20261103t065115z,宿主机6195端口维持只绑127.0.0.1:6195:6195; - 按原 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插件钩子。
搞清楚这两条分叉路径后,修法就必须两头堵:
- 插件侧(
output_guard.py):把<ref>...</ref>纳入标签剥离规则,支持跨多个Plain消息段合并清理,同时依然保护 Markdown 代码块(```)、行内代码与引用块里的合法示例文本; - Dashboard 核心侧(
BotMessageAccumulator):在流式/非流式共用的累积器里加上跨 chunk 的状态机清洗器——用原始未清洗文本去解析搜索引用索引、生成结构化的refs来源元数据卡片,而用剥离<ref>后的干净文本做实时 SSE 推送与数据库落盘。这样前端底部的参考来源卡片一个不少,正文里又不会出现刺眼的<ref>源码; - 清洗存量历史:备份
data_v4_before_history_cleanup.sqlite后,把platform_message_history.id=102255及对应会话历史里的 8 处<ref>包装洗干净(保留其 7 条结构化来源元数据),并将打好补丁的容器再次固化为local/astrbot-ref-clean:20261107。