Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[Bug] 知识库图片访问返回 500：large object 90563 does not exist

オープン
  • 何か問題がありますか？
#7,356 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@ump45nose がすでに取り組んでいます。

2026年10月16日 から。

  • #7362 @ump45nose による — オープン

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
35/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
停滞
技術スタック
postgresql, python
領域
backend, databases

調査の方向性

Start with apps/oss/serializers/file.py and trace FileSerializer.Operate.get() through File.get_bytes() to the lo_get() read path. Reproduce the missing large object using the issue's SQL steps, then decide how the endpoint should report missing file data without exposing the PostgreSQL error. Done means the response has clear semantics and the reproducer no longer returns the raw database error; an open linked pull request shows work is already underway.

索引モデルが issue の本文から書いたものです。

説明

Contact Information

申凯波

MaxKB Version

v2.10.7-lts

Problem Description

访问知识库文档中的图片地址返回 500：

  • URL：https://<MaxKB域名>/oss/file/<file_id>
  • 响应：{"code": 500, "message": "large object 90563 does not exist", "data": null}
现象
  1. 接口返回 500，错误信息为 large object 90563 does not exist（PostgreSQL 原始报错直接透出）
  2. 该报错说明 file 表中对应文件记录仍然存在（若记录不存在，接口会返回 404 "File not found"），但其 loid（90563）指向的大对象在数据库中已不存在，即"元数据在、二进制数据丢"
  3. 影响：该图片无法访问，知识库分段/问答中引用该图片的位置显示异常
  4. 大对象缺失的具体原因尚未定位
Steps to Reproduce

在全新的 v2.10.7-lts 环境（Docker 部署）中可 100% 复现该现象：

  1. 上传一个含图片的文档（如 docx/pdf）到知识库，等待解析完成；或通过聊天窗口发送任意图片/文件

  2. 在浏览器登录后打开该文件地址 https://<MaxKB域名>/oss/file/<file_id>，此时文件正常显示

  3. 进入 MaxKB 的 PostgreSQL 数据库（Docker 部署时为 maxkb 库），查出该文件对应的大对象 ID：

    SELECT loid FROM file WHERE id = '<file_id>';

  4. 删除该大对象，模拟"file 记录存在、但大对象缺失"的数据库状态：

    SELECT lo_unlink('<上一步查出的 loid>');

  5. 再次访问 https://<MaxKB域名>/oss/file/<file_id>，返回：

    {"code": 500, "message": "large object <loid> does not exist", "data": null}

说明：任意来源的文件（知识库图片、聊天附件等）均走同一个 File.get_bytes() → lo_get() 读取路径，用任意文件复现同样有效。第 4 步仅用于模拟线上观察到的数据库状态，大对象缺失的真实原因尚未定位。

The expected correct result
  1. 文件数据应完整保留，文件地址可正常访问；或
  2. 当文件数据已丢失时，接口应返回语义明确的错误（如 404/410 及友好提示），不应将数据库原始报错以 500 形式透出给前端
Related log output
{"code": 500, "message": "large object 90563 does not exist", "data": null}
Additional Information

  • 出问题的代码路径：apps/oss/serializers/file.py FileSerializer.Operate.get() → File.get_bytes() → SELECT lo_get(loid::oid, ...)（PostgreSQL 错误 42704）

  • 数据库中核对该文件状态的 SQL：

    SELECT id, file_name, loid, sha256_hash, source_type, source_id, create_time
FROM file WHERE id = '<file_id>';

SELECT oid FROM pg_largeobject_metadata WHERE oid = '<loid>';  -- 无结果即大对象已缺失
主要言語
Python
スター
22.9k
フォーク
3.2k
平均マージ
1時間 43分
マージ済み PR（30日）
238

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

1Panel-dev/MaxKB のほかの issue

1Panel-dev/MaxKB の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。