使用JayDeBeApi向MySQL存储binary(16)类型UUID的正确方法

问题根因 #

1. 单参数执行报错的原因：你写的(uuid.uuid4().bytes)不是Python元组，会被识别为普通bytes对象，参数绑定时会迭代bytes的16个字节作为16个独立参数，自然超出你定义的1个参数位。正确的单元素元组写法需要加末尾逗号：(uuid.uuid4().bytes,)
2. 双参数无报错但存储全0的原因：JayDeBeApi的默认类型映射没有适配Python原生bytes类型，底层JDBC驱动收到无效参数，最终存储为全0二进制。

通用解决方案（不依赖数据库特定函数） #

你可以直接使用JayDeBeApi遵循DB API 2.0规范提供的Binary()方法封装bytes类型，基于JDBC标准的二进制参数绑定逻辑实现，完全兼容MySQL和H2环境，不需要调用UNHEX这类数据库专属函数：

import uuid
import jaydebeapi

# 单参数插入
curs.execute(
    'INSERT INTO `user` (userId) VALUES (?)',
    (jaydebeapi.Binary(uuid.uuid4().bytes),)
)

# 多参数插入
curs.execute(
    'INSERT INTO `user` (userId,username) VALUES (?, ?)',
    (jaydebeapi.Binary(uuid.uuid4().bytes), 'some_user')
)

方案说明 #

• 切换MySQL/H2环境不需要修改SQL语句，完全满足生产运行、测试验证的兼容需求。
• 读取数据时返回的结果直接是Python bytes类型，通过uuid.UUID(bytes=查询返回的bytes值)即可直接还原为UUID对象，和你之前使用pymysql的使用习惯一致。

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