如何将文件关联到数据库？SQLite发票场景技术问询

嘿，这个问题我碰到过好多次了，给你梳理两种核心方向：直接用SQLite存储PDF，或者用外部存储配合数据库记录关联信息，每种都有各自的适用场景，咱们一个个说。

一、直接在SQLite中存储PDF（BLOB类型） #

SQLite支持BLOB（二进制大对象）类型，完全可以存储300-700KB的PDF文件，操作起来也不复杂。

具体实现步骤 #

1. 创建包含BLOB字段的表

CREATE TABLE invoices (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    invoice_date DATE NOT NULL,
    invoice_number TEXT UNIQUE NOT NULL,
    company_name TEXT NOT NULL,
    pdf_blob BLOB -- 用于存储PDF的二进制数据
);

2. 插入PDF数据到数据库
   以Python的sqlite3库为例，代码如下：

import sqlite3
import os

# 连接到SQLite数据库
conn = sqlite3.connect('invoices.db')
cursor = conn.cursor()

# 读取本地PDF文件的二进制数据
pdf_file_path = "./invoice_samples/INV-2024-0001.pdf"
with open(pdf_file_path, 'rb') as pdf_file:
    pdf_binary_data = pdf_file.read()

# 插入发票记录及PDF数据
cursor.execute('''
INSERT INTO invoices (invoice_date, invoice_number, company_name, pdf_blob)
VALUES (?, ?, ?, ?)
''', ('2024-05-20', 'INV-2024-0001', 'XYZ科技有限公司', pdf_binary_data))

# 提交更改并关闭连接
conn.commit()
conn.close()

3. 从数据库中读取并导出PDF

import sqlite3

conn = sqlite3.connect('invoices.db')
cursor = conn.cursor()

# 根据发票编号查询对应的PDF数据
cursor.execute('SELECT pdf_blob FROM invoices WHERE invoice_number = ?', ('INV-2024-0001',))
result = cursor.fetchone()

if result:
    # 将二进制数据写入本地文件
    with open('导出的发票.pdf', 'wb') as output_file:
        output_file.write(result[0])
    print("PDF导出成功！")
else:
    print("未找到对应发票的PDF文件")

conn.close()

该方案的优缺点 #

• 优点：发票数据和PDF文件完全绑定，不会出现“数据库有记录但文件丢失”的情况；不需要额外维护文件系统的路径规则，迁移时只需要备份一个数据库文件。
• 缺点：数据库体积会随着PDF数量增加快速膨胀，备份和传输成本变高；查询BLOB字段的性能比纯文本字段差，批量处理PDF时操作不如直接访问文件系统灵活。

二、更实用的替代方案 #

如果你的场景更看重性能、灵活性和易维护性，以下几种方案会更合适：

1. 文件系统存储+数据库存文件路径（最推荐） #

这是实际开发中最常用的方案：把PDF文件存在本地文件夹，数据库只记录文件的相对路径（推荐用相对路径，方便后续迁移）。

实现步骤

• 新建一个专门的文件夹（比如invoice_pdfs/）统一存放所有发票PDF；
• 给每个PDF文件命名为唯一标识（比如用发票编号INV-2024-0001.pdf，避免重名）；
• 修改数据库表结构，新增pdf_file_path字段：

CREATE TABLE invoices (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    invoice_date DATE NOT NULL,
    invoice_number TEXT UNIQUE NOT NULL,
    company_name TEXT NOT NULL,
    pdf_file_path TEXT NOT NULL -- 例如 'invoice_pdfs/INV-2024-0001.pdf'
);

优点

• 数据库体积小，查询速度快；
• 可以直接用系统文件管理器查看、备份PDF，批量处理（比如打印、OCR识别）更方便；
• 迁移时只需要同时备份数据库和PDF文件夹即可。

注意事项

• 确保文件名唯一，避免覆盖已有文件；
• 定期校验数据库记录和文件的一致性，清理无效的记录或文件；
• 注意文件夹的权限设置，避免非授权访问。

2. 轻量级本地对象存储 #

如果你的需求更复杂（比如需要权限控制、版本管理、多设备访问），可以部署一个轻量级的本地对象存储服务（比如MinIO），数据库中存储PDF文件的唯一对象ID，而非路径。这种方案比文件系统更规范，还能支持生成临时访问链接、设置文件过期时间等高级功能，适合有一定规模的场景。

3. 混合存储方案 #

如果部分PDF文件极小，部分偏大，可以考虑混合策略：比如小于500KB的PDF存在SQLite的BLOB字段中，大于的存在文件系统。不过这个方案会增加业务逻辑的复杂度，除非有特殊需求，否则不推荐。

总结一下：如果追求数据完整性优先、场景简单，选SQLite BLOB方案；如果看重性能、灵活性和易维护性，文件系统+数据库存路径是最优解。

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