Skip to content

[bug] 飞牛 fnOS 原生版 FPK:对话持续报 database disk image is malformed(1.0.3b6 仍复现,卸载重装与降低 checkpoint 压力均无效) #2998

Open

Description

@rayyugz

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 写入路径的版本:

  1. Octop#2924 — 下线 history v2,启动时把已有归档迁回原有历史表
    逐线程开事务提交,写入 thread_messages / trajectory_events,并在每个线程后重命名归档文件。

  2. 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

1.0.3b6 的全部改动仅为 2 个 PR(#2995 托管专家保存时保留 backend、#2996 release),未触及 SQLite / history / migration 任何方面,故未修复本问题。

Expected behavior

对话应正常返回模型回复,不出现 database disk image is malformed 错误气泡。

Steps to reproduce

  1. 在飞牛 NAS(fnOS,x86_64)上,通过应用中心手动安装 Octop-fnos-native-amd64-1.0.3b6.fpk(或从 1.0.3b1/b2 升级而来)。
  2. 配置模型 Provider 与 API Key,新建一个专家。
  3. 与该专家对话,触发模型调用。
  4. 观察到「模型调用失败: database disk image is malformed (code: stream_error, source: history / frontend_stream)」错误气泡,回复中断。

关键前置条件(推测,供复现参考):该实例在早期版本使用期间,agent 的 memory.sqlite 曾大量累积 checkpoint(定时任务 / cron 场景尤甚)。全新空白实例可能不复现——本单在保留旧数据重装后仍复现,指向旧库遗留的损坏状态被新版继承。

Environment

  • octop version: 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 中的真实异常栈尚未提取。正在进一步定位后补充。

请求官方协助确认的问题

  1. 如何在不清空全部数据的前提下修复已损坏的 SQLite 库?
    是否有官方支持的修复入口(例如 memory 存储页的备份恢复 API POST /api/.../memory-storage/restore)?该入口的备份来源 memory.sqlite.before-slim.<uuid>.bak 在本实例中是否存在,需要如何确认?
  2. 是否存在官方支持的「仅重置数据库、保留配置与工作区」的路径?
    卸载向导只有「保留数据」和「完全删除」两档;前者会继承损坏库,后者会连同模型 Key、专家、连接器、定时任务一并删除。
  3. 1.0.3b5 引入的启动迁移(chore: retire versioned history after startup migration #2924)与每小时 checkpoint 裁剪(harness#248)是否存在已知的数据损坏风险,是否有对应的规避配置或修复版本?
  4. 是否建议在修复前先降级到 1.0.3b4(裁剪与启动迁移引入前的最后一版)以规避问题?
  5. 能否提供 logs/octop.log 中 database disk image is malformed 的原始 traceback 的定位方法(在 FPK native 部署下,OCTOP_HOME 的准确路径推导规则),以便自查。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions