SQLite插入数据报错：参数3绑定失败，如何修正表结构？

报错「Error binding parameter 3 - probably unsupported type」的核心原因：你传入的snippet['thumbnails']是Python字典类型，而SQLite的TEXT字段仅支持字符串类型数据，类型不匹配导致绑定失败。

存储方案与表结构调整 #

可选存储方案 #

针对YouTube缩略图数据（通常包含多尺寸链接，如default/medium/high），有两种实用存储方式：

• 单链接存储：若仅需某一固定尺寸的图片链接，直接提取对应字符串存入TEXT字段，当前表结构无需修改。
• 全数据序列化存储：若需保留所有尺寸链接，将字典序列化为JSON字符串存入TEXT字段；SQLite 3.31.0+版本也可将字段类型改为JSON（本质仍是TEXT，增加JSON语法校验），修改语句如下：

ALTER TABLE youtube_video ALTER COLUMN thumbnails TYPE JSON;

注：低版本SQLite不支持JSON类型，继续使用TEXT即可。

修正插入代码 #

方案1：提取单个缩略图链接（以high尺寸为例） #

# 优先取high尺寸链接，无则降级为default
thumbnail_url = snippet['thumbnails'].get('high', {}).get('url', '')

cursor.execute(insert_query, (
    snippet['publishedAt'],
    snippet['title'],
    snippet['channelId'],
    thumbnail_url,  # 传入字符串类型
    snippet['channelTitle'],
    int(statistics.get('viewCount', 0)),  # 统计值转整数，避免类型错误
    int(statistics.get('likeCount', 0)),
    int(statistics.get('dislikeCount', 0)),
    int(statistics.get('favoriteCount', 0)),
    content_details['duration'],
    video_id,
    transcript,
))

方案2：序列化字典为JSON字符串 #

需导入json模块：

import json

# 将字典转为JSON字符串
thumbnails_json = json.dumps(snippet['thumbnails'])

cursor.execute(insert_query, (
    snippet['publishedAt'],
    snippet['title'],
    snippet['channelId'],
    thumbnails_json,  # 传入JSON字符串
    snippet['channelTitle'],
    int(statistics.get('viewCount', 0)),
    int(statistics.get('likeCount', 0)),
    int(statistics.get('dislikeCount', 0)),
    int(statistics.get('favoriteCount', 0)),
    content_details['duration'],
    video_id,
    transcript,
))

后续查询时可反序列化为字典：

cursor.execute("SELECT thumbnails FROM youtube_video WHERE video_id = ?", (video_id,))
result = cursor.fetchone()
if result:
    thumbnails_dict = json.loads(result[0])

额外注意事项 #

• YouTube API返回的统计字段（viewCount等）是字符串类型，插入前需转为整数，避免后续计算或查询异常。
• 确保insert_query的占位符数量与传入参数数量完全匹配。

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