Flutter中能否在设备本地SQL数据库存储PDF文件？

算力阿峰

2026-5-14

当然可以做到！在Flutter里，你完全能把PDF文件存储到本地SQL数据库中——核心思路是把PDF转换成二进制数据，用数据库的*BLOB（二进制大对象）*类型来存储。下面给你拆解具体步骤和注意事项：

1. 先把PDF转成二进制数据

Flutter里处理二进制数据最常用的是Uint8List类型，你可以从本地文件读取，或者从网络下载后获取PDF的二进制内容：

// 示例：从本地文件读取PDF的二进制数据
File pdfFile = File('/storage/emulated/0/Download/sample.pdf');
Uint8List pdfBytes = await pdfFile.readAsBytes();

2. 调整你的数据库表结构

需要给现有表新增一个类型为BLOB的字段，用来存储二进制数据。比如用sqflite插件的话，建表语句可以修改成这样：

CREATE TABLE saved_docs (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  doc_name TEXT NOT NULL,
  doc_size INTEGER NOT NULL,
  pdf_blob BLOB -- 新增这个字段存储PDF二进制
);

3. 将PDF数据插入数据库

把刚才得到的Uint8List直接作为参数插入到对应的BLOB字段即可，sqflite这类插件会自动处理类型转换：

// 插入示例
await database.insert(
  'saved_docs',
  {
    'doc_name': '用户手册.pdf',
    'doc_size': pdfBytes.length,
    'pdf_blob': pdfBytes,
  },
);

4. 从数据库读取并还原PDF

读取时会拿到Uint8List格式的二进制数据，你可以把它写回本地文件，或者直接用PDF预览插件打开：

// 读取指定ID的PDF数据
List<Map<String, dynamic>> queryResults = await database.query(
  'saved_docs',
  where: 'id = ?',
  whereArgs: [1],
);

Uint8List? retrievedPdfBytes = queryResults.first['pdf_blob'] as Uint8List?;

// 示例：还原成本地文件
if (retrievedPdfBytes != null) {
  File restoredPdf = File('/storage/emulated/0/Documents/restored_manual.pdf');
  await restoredPdf.writeAsBytes(retrievedPdfBytes);
}

额外注意事项

虽然这种方法可行，但如果你的PDF文件体积很大（比如几十MB以上），直接存在数据库里可能会拖慢数据库查询和读写性能，更推荐的做法是把PDF存在本地文件系统，数据库只存储文件的路径和元数据（名称、大小等）。
不管你用sqflite、moor还是其他Flutter SQL插件，对BLOB类型的支持逻辑都是一致的，核心就是二进制数据的转换和存储。

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