问题描述

使用 SeaORM（底层为 SQLx 0.8 MySQL 驱动）通过 prepared statement 插入 BOOLEAN 字段并绑定 true 时，落库结果为 NULL，而非 true。

复现方式

use sea_orm::{ActiveModelTrait, Set};

let st = sea_type::ActiveModel {
    bool_val: Set(true),
    ..Default::default()
};
st.insert(db).await?;
// 读取后 loaded.bool_val == None（NULL），期望为 true

SeaORM 将 bool 绑定为参数类型 TINY，并声明 UNSIGNED 标志，因此 16 位参数类型字段为 0x8001（低字节 = 类型 TINY=1，高字节 = flag 0x80）。

根因

COM_STMT_EXECUTE 参数类型字段按协议为 16 位：低 8 位是类型，高 8 位是标志（UNSIGNED/BINARY/BLOB 等）。dolphin 的 make_stmt_parameters_bytype() 用完整 16 位值直接和 DOLPHIN_TYPE_* 常量比较，导致高字节标志使比较失败，参数类型分派落入 default（参数 type 保持初始值 0），值未被正确解析，最终存为 NULL。

修复

contrib/dolphin/plugin_protocol/dqformat.cpp 的 make_stmt_parameters_bytype()：

- switch (stmt_param->itypes[i]) {
+ switch (stmt_param->itypes[i] & 0xff) {

只比较低 8 位类型，正确忽略高 8 位标志。对所有 DOLPHIN_TYPE_*（1~255，均 ≤255）无损；同时修复带 UNSIGNED 标志的整数等参数。

验证

• 修复前：BOOLEAN 绑定 true 存储为 NULL。
• 修复后：bool roundtrip = true；decimal/datetime/json/blob/null 类型 roundtrip 全部通过。

结论

原实现未剥离参数类型字段的高位标志即参与比较，属协议边界错误（正确性缺陷），对无标志参数无影响，对带标志参数（含 bool）修复。

关联 MR：基于 seaorm-fix-prep-mask 分支提交。