Wappler中用Knex操作MySQL BIT类型：返回Buffer而非布尔值问题

原因分析 #

首先得纠正一个认知：MySQL的BIT类型和布尔类型不是等价的。BIT是专门存储二进制位的类型，哪怕是BIT(1)，它底层存储的是单个二进制位，而非像TINYINT(1)（MySQL里BOOLEAN的本质）那样直接映射为数字0/1。

Knex作为SQL查询构建工具，默认不会自动转换BIT类型的返回值——因为BIT可以定义任意长度（比如BIT(4)存储4个二进制位），Knex无法预判你需要把它转成什么格式，所以直接返回了MySQL驱动传递过来的原始Buffer对象，其中data数组里的数值就是二进制位对应的十进制值（比如[1]对应二进制位1）。

解决办法 #

1. 手动转换查询结果

在拿到查询结果后，直接处理Buffer字段：

// 转成1/0格式
row.is_active = row.is_active.data[0];
// 或者转成布尔值
row.is_active = Boolean(row.is_active.data[0]);

2. 修改表字段类型（推荐）

如果你的业务场景确实只需要布尔状态，直接把BIT(1)改成TINYINT(1)或者BOOLEAN（MySQL里BOOLEAN是TINYINT(1)的别名）。这样Knex会自动将字段值返回为1/0，或者根据配置返回true/false，完全符合你的预期。

3. 配置Knex自动转换

在Knex的连接配置里添加typeCast函数，自定义BIT类型的转换逻辑，比如只针对长度为1的BIT字段转成布尔值：

const knex = require('knex')({
  client: 'mysql',
  connection: {
    host: '你的数据库地址',
    user: '用户名',
    password: '密码',
    database: '数据库名',
    typeCast: (field, next) => {
      // 仅处理长度为1的BIT字段
      if (field.type === 'BIT' && field.length === 1) {
        const bitValue = field.string();
        return bitValue ? bitValue.charCodeAt(0) === 1 : false;
      }
      // 其他类型按默认逻辑处理
      return next();
    }
  }
});

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