React Native iOS/Android端PDF离线存储与搜索实现方案咨询

一、PDF存储方案选择 #

1. 本地文件系统存储 #

• 适合大体积PDF，借助react-native-fs库将PDF保存到应用私有目录（如DocumentDirectoryPath），避免被系统自动清理。
• 需在SQLite中记录文件路径、文件名、上传时间等元数据，方便后续关联索引信息。

2. SQLite Blob存储 #

• 适合几MB以内的小体积PDF，直接将PDF二进制数据存入SQLite的BLOB字段。
• 注意：SQLite对大BLOB的读写性能弱于文件系统，且会快速增大数据库体积，需根据业务场景权衡。

二、PDF文本提取（索引核心前提） #

要实现内容搜索，必须先提取PDF中的文本内容，常用实现方式：

• 用react-native-pdf库：支持加载PDF并调用getText()方法提取指定页面或全文文本。
• 用pdf-parse配合react-native-fs：通过react-native-fs读取本地PDF为Uint8Array，传入pdf-parse解析文本（需适配RN环境）。

三、离线搜索实现方案 #

1. SQLite FTS5全文搜索（推荐） #

• 若用SQLite存储元数据或Blob，可创建FTS5虚拟表专门存储索引数据：

  CREATE VIRTUAL TABLE pdf_index USING fts5(
    pdf_id,       -- 关联PDF的主键（文件路径或Blob ID）
    title,        -- PDF标题/文件名
    content,      -- 提取的PDF文本内容
    upload_time   -- 上传时间
  );
  

• PDF上传完成并提取文本后，将数据插入FTS5表，SQLite会自动完成索引构建。
• 搜索时直接使用FTS5的高效查询语法：

  SELECT pdf_id, title FROM pdf_index WHERE content MATCH '搜索关键词';
  

• 无需额外插件，SQLite原生支持，性能远优于普通LIKE模糊查询。

2. 第三方离线搜索引擎库 #

Lunr.js

• 轻量级全文搜索引擎，可直接在RN环境使用。
• 实现步骤：
  • 上传PDF时提取文本和元数据，构建Lunr文档对象。
  • 生成Lunr索引，将索引序列化为JSON字符串，存入AsyncStorage或本地文件。
  • 搜索时加载索引，调用Lunr搜索方法获取匹配结果，再关联对应的PDF存储位置。

Realm数据库

• Realm原生支持全文搜索，适合需要复杂数据模型的场景。
• 定义Realm模型时，对content字段添加全文索引属性：

  class PDFSchema extends Realm.Object {
    static schema = {
      name: 'PDF',
      properties: {
        id: 'string',
        title: 'string',
        content: { type: 'string', indexed: 'full-text' },
        filePath: 'string?', // 本地文件路径（文件存储时用）
        blobData: 'data?',   // Blob数据（SQLite存储时可存在Realm）
        uploadTime: 'date'
      },
      primaryKey: 'id'
    };
  }
  

• 上传PDF时将数据存入Realm，系统自动完成索引，搜索时直接用Realm查询：

  const results = realm.objects('PDF').filtered('content CONTAINS[c] "搜索关键词"');
  

四、针对问题的具体解答 #

1. SQLite Blob形式存储的搜索插件 #

没有专门针对SQLite Blob的搜索插件——Blob是二进制数据，无法直接检索。必须先提取PDF文本，将文本存入SQLite普通字段或FTS5虚拟表，再基于文本进行搜索。

2. 支持即时索引的React Native搜索引擎库 #

• SQLite FTS5：插入数据时自动完成索引，上传PDF并提取文本后插入FTS5表即可完成索引，无需额外操作。
• Realm：存入数据时自动构建全文索引，索引实时可用。
• Lunr.js：上传时生成索引并保存，索引过程可在上传完成后同步执行，实现即时索引。

内容的提问来源于stack exchange，提问作者Amir