在SQLite中存储二进制数据时，需要用到BLOB类型字段，很多开发者初次操作时会因为不知道正确的参数传递方式，导致数据插入后无法正确读取。下面我们就详细讲解SQLite插入二进制数据的完整操作方法。
SQLite BLOB类型说明
SQLite的BLOB类型用于存储二进制大对象，可以保存任意格式的二进制数据，比如图片、音频、压缩包、序列化后的对象等。它不会像文本类型那样对数据做编码转换，能完整保留原始二进制内容，是存储非文本数据的首选类型。
创建包含BLOB字段的表时，语法和普通字段没有区别，示例如下：
-- 创建测试表，binary_data字段为BLOB类型
CREATE TABLE IF NOT EXISTS binary_test (
id INTEGER PRIMARY KEY AUTOINCREMENT,
file_name TEXT NOT NULL,
binary_data BLOB,
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);Python中插入二进制数据的方法
Python的sqlite3模块原生支持BLOB数据插入，只需要把二进制数据作为bytes类型参数传递给占位符即可，不需要做额外的编码处理。
下面是读取本地图片并插入到SQLite的完整示例：
import sqlite3
def insert_binary_data(file_path, file_name):
# 连接SQLite数据库，如果不存在会自动创建
conn = sqlite3.connect('test.db')
cursor = conn.cursor()
# 读取二进制文件内容，得到bytes类型数据
with open(file_path, 'rb') as f:
binary_content = f.read()
# 执行插入语句，使用占位符传递参数，binary_content作为BLOB参数传入
sql = "INSERT INTO binary_test (file_name, binary_data) VALUES (?, ?)"
cursor.execute(sql, (file_name, binary_content))
# 提交事务并关闭连接
conn.commit()
conn.close()
print("二进制数据插入成功")
if __name__ == '__main__':
# 插入本地名为test.png的图片
insert_binary_data('./test.png', 'test.png')Java中插入二进制数据的方法
Java操作SQLite时，需要使用PreparedStatement的setBytes方法传递二进制参数，同样不需要手动做编码转换。
import java.io.FileInputStream;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
public class SQLiteBinaryInsert {
public static void insertBinary(String filePath, String fileName) {
Connection conn = null;
PreparedStatement pstmt = null;
try {
// 连接SQLite数据库
conn = DriverManager.getConnection("jdbc:sqlite:test.db");
String sql = "INSERT INTO binary_test (file_name, binary_data) VALUES (?, ?)";
pstmt = conn.prepareStatement(sql);
pstmt.setString(1, fileName);
// 读取文件二进制内容，传入setBytes方法
FileInputStream fis = new FileInputStream(filePath);
pstmt.setBytes(2, fis.readAllBytes());
pstmt.executeUpdate();
System.out.println("二进制数据插入成功");
fis.close();
} catch (Exception e) {
e.printStackTrace();
} finally {
try {
if (pstmt != null) pstmt.close();
if (conn != null) conn.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
}插入二进制数据的注意事项
- 插入二进制数据时，一定要使用参数化查询，不要直接拼接SQL字符串，否则会存在SQL注入风险，也可能导致二进制数据中的特殊字符破坏SQL语法。
- 二进制数据较大时，建议分批次读取插入，避免一次性加载全部数据到内存导致内存溢出。
- 插入完成后如果要验证数据是否正确，可以将BLOB字段的内容读取出来，和原始文件的二进制内容做对比，确认完全一致。
- 如果二进制数据为空，也可以插入NULL值到BLOB字段，SQLite允许BLOB字段存储NULL。
二进制数据读取验证
插入完成后，我们可以通过查询语句读取BLOB字段内容，验证数据是否正确。以下是Python读取并保存为文件的示例：
import sqlite3
def read_binary_data(file_name, save_path):
conn = sqlite3.connect('test.db')
cursor = conn.cursor()
sql = "SELECT binary_data FROM binary_test WHERE file_name = ?"
cursor.execute(sql, (file_name,))
result = cursor.fetchone()
if result and result[0]:
# 将读取到的二进制数据写入新文件
with open(save_path, 'wb') as f:
f.write(result[0])
print("二进制数据读取并保存成功")
else:
print("未找到对应数据")
conn.close()
if __name__ == '__main__':
read_binary_data('test.png', './new_test.png')
SQLiteBLOB二进制数据插入数据库操作Python_SQLite修改时间：2026-05-30 21:19:03