如何用Python向SQLite3数据库插入不同长度的嵌套列表？

问题原因 #

你遇到的Incorrect number of bindings supplied错误，核心原因是executemany要求每个待插入项是单个参数的序列（比如元组），但你直接传入了子列表（比如['HARPER', 'RORY', 'THOMAS']），SQLite会把这个子列表里的3个元素当成3个绑定参数，而你的INSERT语句只需要1个参数，参数数量不匹配导致报错。

解决方案 #

要把每个子列表存入单个text列，需要先将子列表转换成单个字符串值，再包装成元组作为executemany的参数项。推荐两种常用方式：

方法1：逗号分隔字符串 #

适合简单场景，直接用分隔符拼接子列表元素：

import sqlite3

project_db = "your_database.db"  # 替换为你的数据库路径

# 要插入的嵌套列表
list_of_scene_char_lists = [['HARPER', 'RORY', 'THOMAS'], ['AUGUST', 'THOMAS'], []]

# 插入数据函数
def auto_characters(list_of_scene_char_lists):
    conn = sqlite3.connect(project_db)
    c = conn.cursor()
    # 将每个子列表转为逗号分隔字符串，空列表转为空字符串
    formatted_data = [(','.join(chars),) for chars in list_of_scene_char_lists]
    c.executemany("INSERT INTO characters VALUES (?)", formatted_data)
    conn.commit()
    conn.close()

auto_characters(list_of_scene_char_lists)

方法2：JSON序列化（推荐） #

如果后续需要将字符串还原成列表，JSON序列化更可靠，避免分隔符冲突：

import sqlite3
import json

project_db = "your_database.db"  # 替换为你的数据库路径

# 要插入的嵌套列表
list_of_scene_char_lists = [['HARPER', 'RORY', 'THOMAS'], ['AUGUST', 'THOMAS'], []]

# 插入数据函数
def auto_characters(list_of_scene_char_lists):
    conn = sqlite3.connect(project_db)
    c = conn.cursor()
    # 用JSON序列化每个子列表
    formatted_data = [(json.dumps(chars),) for chars in list_of_scene_char_lists]
    c.executemany("INSERT INTO characters VALUES (?)", formatted_data)
    conn.commit()
    conn.close()

auto_characters(list_of_scene_char_lists)

# 读取时还原列表的示例
def get_characters():
    conn = sqlite3.connect(project_db)
    c = conn.cursor()
    c.execute("SELECT scene_characters FROM characters")
    results = c.fetchall()
    # 反序列化JSON字符串为列表
    return [json.loads(item[0]) for item in results]

补充说明 #

• 空列表转换后会变成空字符串（方法1）或[]（方法2），均可正常存入数据库
• 如果业务需求允许，也可以考虑拆分表（比如场景表、人物表+关联表）实现结构化存储，但如果必须存入单个列，上述方法完全满足需求

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