Repository navigation
Description
What happened
在飞牛 NAS(fnOS)上使用官方 FPK 安装包部署 Octop 后,对话持续报错:
模型调用失败: database disk image is malformed
code: stream_error
source: history
重试 / 刷新页面后,同一错误以另一种标签再次出现:
模型调用失败: database disk image is malformed
code: stream_error
source: frontend_stream
错误气泡下方带「重试」按钮,助手回复中断。
关键点:这不是模型配置问题
界面文案「模型调用失败」具有误导性。经排查,该文案是 format_stream_error 对未分类异常的兜底(i18n/domains/stream.py 最后一行返回 MODEL_CALL_FAILED),底层真实异常是 SQLite 层的 database disk image is malformed(SQLITE_CORRUPT)。
source: history 这一标签来自 dashboard/src/pages/Chat/hooks/useChat.ts:503——它是从历史记录里读出的已存错误消息,说明该错误已被写入 thread_messages 投影;而执行回合时读取 agent 记忆库(checkpoint)同样失败。
已确认:
- 更换模型 / 新建专家后仍然复现
- 同一台飞牛上的其他应用(openclaw、searxng、Docker 容器等)全部正常
- 与模型供应商、API Key、模型配置无关
已尝试且均未解决的方案
| # | 尝试 | 结果 |
|---|---|---|
| 1 | 检查模型配置、重配 Provider / API Key | 无效,与模型无关 |
| 2 | 应用内更新升级到 1.0.3b5 | 无效 |
| 3 | 应用内更新升级到 1.0.3b6(2026-11-15 发布,最新) | 无效 |
| 4 | 在「应用设置 → 环境变量」加入 OCTOP_CHECKPOINT_KEEP_LAST=5 / OCTOP_CHECKPOINT_RETENTION=thread / OCTOP_CHECKPOINT_BACKUP_BEFORE_PRUNE=first,并重启服务 |
无效 |
| 5 | 飞牛应用中心卸载 Octop(卸载向导选择「保留数据」,保留 data-share),随后重新安装 Octop-fnos-native-amd64-1.0.3b6.fpk |
无效,损坏随旧数据目录一并继承 |
| 6 | 手动检索磁盘上所有 octop.db / memory.sqlite / .octop 目录 |
未定位到异常库文件 |
卸载重装的关键细节
按官方 FPK 的实现(fnos/native/cmd/install_callback):
DATA_DIR="${TRIM_DATA_SHARE_PATHS%%:*}" # 飞牛注入的第一个 data-share 路径
export OCTOP_HOME="${DATA_DIR}/.octop"且 install_callback:78 明确:
if [ -f "${DATA_DIR}/.octop/octop.db" ]; then
octop_mark_fnos_passwd_pending "$DATA_DIR"
fi即重装时若 data-share 下已存在 octop.db,安装脚本会直接沿用旧库,不做重建。因此「卸载 → 保留数据 → 重装」并不能得到干净的数据层,损坏状态被完整继承,重装后立即复现。
补充:卸载向导只有「保留数据」和「完全删除」两个选项,没有「仅重装程序、保留并重建数据库」的选项。
怀疑的引入点(1.0.3b5)
1.0.3b5 是唯一同时引入了两条新 SQLite 写入路径的版本:
-
Octop#2924— 下线 history v2,启动时把已有归档迁回原有历史表
逐线程开事务提交,写入thread_messages/trajectory_events,并在每个线程后重命名归档文件。 -
octop-harness#248+octop-memory#43— 引入每小时定时 checkpoint 裁剪
prune_checkpoints+VACUUM,依赖感知保留策略(keep_last默认 20)。
而 octop-memory#43 的说明提到,裁剪前默认会整份复制 memory.sqlite 作为备份(OCTOP_CHECKPOINT_BACKUP_BEFORE_PRUNE)。在 first 模式下,若备份因磁盘空间不足失败,官方设计是「记录 warning 并继续裁剪」——即空间不足时仍会删数据但不留下后路。
相关已知 issue
- [bug] octop经常执行报错database disk image is malformed #1917
[bug] octop经常执行报错database disk image is malformed(2026-10-12 开,1.0.2b6 即出现,至今 open)
该 issue 正文的结论与本单一致:「症状被一次重启暂时压住,根因仍在,下次 CLI embedded runtime 触发即复现」。 - [bug] Agent 瀵硅瘽鎶ャ€屾ā鍨嬭皟鐢ㄥ�氭�¢噸璇曞悗浠嶅け璐ャ€嶆牴鍥犳槸 memory.sqlite 鐨?checkpoint/writes 鏃犱笂闄愮疮绉�锛�230MB锛夎Е鍙?database disk image is malformed #1171 根因分析:
memory.sqlite的 checkpoint / writes 无上限累积(实测 230MB),叠加memory.maintenance的 GC/VACUUM 在失效连接上持续失败(关联 sqlite3.ProgrammingError: Cannot operate on a closed database in hourly memory maintenance (292 tracebacks/day), also hits conversation-time capture_turn #484),最终在 GC/VACUUM 时抛出 malformed。 - [bug] 长会话摘要压缩后带图消息以 JSON 字面量进入模型输入致上下文崩坏;同窗口 thread 零 checkpoint(关联 #2978) #2989(2026-11-15 开)环境为飞牛 OS + SQLite(WAL) + octop 1.0.3b5 + octop-harness 1.0.9 + octop_memory 1.0.4,症状包括 checkpoint 体积断崖退化、
channel_values丢失messages键、新 thread 跑 20+ 轮checkpoints0 行 /thread_messages0 行 /threads.last_active = 0(完全不落盘),关联 [bug] 部分线程已有消息但 last_active 未回写(保持 epoch 0) #2978。 - [bug] 部分线程已有消息但 last_active 未回写(保持 epoch 0) #2978 部分线程已有消息但
last_active未回写(保持 epoch 0)。 - [bug] Dashboard 专家对话历史突然变空:thread_messages 投影为空,而 trajectory_events / sessions jsonl 仍完整 #2059 Dashboard 专家对话历史突然变空:
thread_messages投影为空,而trajectory_events/ sessions jsonl 仍完整。
1.0.3b6 的全部改动仅为 2 个 PR(#2995 托管专家保存时保留 backend、#2996 release),未触及 SQLite / history / migration 任何方面,故未修复本问题。
Expected behavior
对话应正常返回模型回复,不出现 database disk image is malformed 错误气泡。
Steps to reproduce
- 在飞牛 NAS(fnOS,x86_64)上,通过应用中心手动安装
Octop-fnos-native-amd64-1.0.3b6.fpk(或从 1.0.3b1/b2 升级而来)。 - 配置模型 Provider 与 API Key,新建一个专家。
- 与该专家对话,触发模型调用。
- 观察到「模型调用失败: database disk image is malformed (code: stream_error, source: history / frontend_stream)」错误气泡,回复中断。
关键前置条件(推测,供复现参考):该实例在早期版本使用期间,agent 的 memory.sqlite 曾大量累积 checkpoint(定时任务 / cron 场景尤甚)。全新空白实例可能不复现——本单在保留旧数据重装后仍复现,指向旧库遗留的损坏状态被新版继承。
Environment
octopversion: 1.0.3b6(Octop-fnos-native-amd64-1.0.3b6.fpk,native 版,非 Docker)octop-harness: 1.0.9(1.0.3b5 引入)octop_memory: 1.0.4(1.0.3b5 引入)- Python version: 飞牛应用商店提供的 Python 3.12
- OS: 飞牛 fnOS(x86_64),数据卷 btrfs
- Install method: 官方 FPK 安装包(
Octop-fnos-native-amd64-1.0.3b6.fpk),本地版 / 端口 8089 - LLM provider (if relevant): 与模型无关(更换模型后同样复现)
Logs / screenshots
界面错误气泡:
出现错误
模型调用失败: database disk image is malformed
code: stream_error
source: history
[重试]
(第二个气泡为 code: stream_error / source: frontend_stream)
尚未取得服务端原始 traceback:由于该实例的 .octop 数据目录路径尚未定位(OCTOP_HOME 未确认),logs/octop.log 中的真实异常栈尚未提取。正在进一步定位后补充。
请求官方协助确认的问题
- 如何在不清空全部数据的前提下修复已损坏的 SQLite 库?
是否有官方支持的修复入口(例如 memory 存储页的备份恢复 APIPOST /api/.../memory-storage/restore)?该入口的备份来源memory.sqlite.before-slim.<uuid>.bak在本实例中是否存在,需要如何确认? - 是否存在官方支持的「仅重置数据库、保留配置与工作区」的路径?
卸载向导只有「保留数据」和「完全删除」两档;前者会继承损坏库,后者会连同模型 Key、专家、连接器、定时任务一并删除。 - 1.0.3b5 引入的启动迁移(chore: retire versioned history after startup migration #2924)与每小时 checkpoint 裁剪(harness#248)是否存在已知的数据损坏风险,是否有对应的规避配置或修复版本?
- 是否建议在修复前先降级到 1.0.3b4(裁剪与启动迁移引入前的最后一版)以规避问题?
- 能否提供
logs/octop.log中database disk image is malformed的原始 traceback 的定位方法(在 FPK native 部署下,OCTOP_HOME的准确路径推导规则),以便自查。
Activity