SQLite 查询含反斜杠的字符串报 bindings：单个参数也要有逗号

Python sqlite3 查询一个字符串，报 Incorrect number of bindings supplied，提示语句只用一个参数，却收到二十五个参数。字符串里恰好有反斜杠时，很容易把问题归到转义。先看 execute() 的第二个参数：(search_criterion) 仍是字符串，只有 (search_criterion,) 才是单元素元组。

这条路径适用于 Python sqlite3 的问号占位符。参数数量恰好等于字符串长度，是把字符串直接传作参数序列的线索；如果数量没有这种关系，还需检查实际占位符和参数集合，不能只补逗号。

括号没有把字符串包装成一个参数

下面是错误写法示例，cursor 是已有连接的游标，表和列需对应实际数据库：

cursor.execute(
    "SELECT genre, style FROM albums WHERE artist = ?",
    (search_criterion),
)

在 Python 中，决定元组的是逗号。第二个参数还是字符串时，sqlite3 会把它作为字符序列处理，而查询只有一个 ?。这里不需要修改反斜杠，也不需要给每个字符增加占位符。

在受控环境检查参数的类型和容器长度，不在生产日志打印完整输入。尤其确认变量是前一次查询结果中的字符串字段，而不是整个结果行；默认结果行通常已经是元组，将整行再次包装可能产生嵌套元组。

保留参数绑定，修正单元素容器

以下是单参数查询的修正示例。search_criterion 应是已经取得的字符串值，不是包含该值的结果行：

cursor.execute(
    "SELECT genre, style FROM albums WHERE artist = ?",
    (search_criterion,),
)
rows = cursor.fetchall()

[search_criterion] 也可以作为长度为一的参数序列。多个问号则提供对应长度的序列，例如 (artist, year)；不应把两个值拼成一个字符串再传进去。

若修正后变成 Error binding parameter 1: type 'tuple' is not supported，检查单个元素本身是否仍是元组。假设前一次查询只返回 artist 一列，默认结果行形如 ("Example Artist",)，要按业务取出其中的字符串，而不是将整行作为一个字段值绑定。查询没有返回记录时，应先处理空结果，不能直接索引第一行。

也可使用命名占位符与字典，但不要混用不同参数形状。下面是同一查询的另一种示例：

cursor.execute(
    "SELECT genre, style FROM albums WHERE artist = :artist",
    {"artist": search_criterion},
)

当前 Python sqlite3 的命名形式要求字典或其子类；Python 3.14 起，给命名占位符传序列会抛 ProgrammingError。现有问号查询不必为了修复一个逗号而全部迁移到命名形式。

不用字符串拼接绕过绑定错误

f-string 拼接后看似能查询，是因为传给数据库的已是一整条 SQL，不再进行同样的参数绑定。这会让输入中的引号等内容参与 SQL 语法，不能作为修复办法。保持值绑定，也不要把 ? 放进 SQL 引号中；被引号包住的问号是字符串内容，不是参数位置。

绑定处理的是字段值，不能借它替换表名、列名或 SQL 关键字。动态查询结构应由项目已审定的规则构造，不能与这里的字符串值包装混为一谈。

修改前保存相关查询代码。在隔离数据中覆盖普通字符串、含反斜杠或引号的字符串，以及没有匹配记录的情况；观察参数数量正确、结果内容符合预期。报错消失但查询结果为空时，再检查输入和数据是否一致，不继续修改转义规则来凑结果。

回退只涉及查询代码，通常不需要修改数据库文件或表结构。若同一参数生成逻辑也用于写入，验收还应检查其写入值，代码回退不会撤销已经提交的记录。