使用JDBI Handle转换MySQL的TINYINT/BIT为Boolean时触发空指针异常

我之前也踩过JDBI处理MySQL这类布尔相关类型的坑，你的问题核心是JDBC驱动对MySQL的BIT(1)和TINYINT(1)的默认映射和JDBI的Boolean期望不匹配，直接转换就会触发类型不匹配甚至空指针异常。下面给你几个实用的解决办法：

1. 自定义类型转换器（最推荐的通用方案） #

写一个自定义的类型转换器，让JDBI明确知道如何把MySQL的BIT/TINYINT类型转换成Java的Boolean。示例代码如下：

import org.jdbi.v3.core.argument.Argument;
import org.jdbi.v3.core.argument.ArgumentFactory;
import org.jdbi.v3.core.config.ConfigRegistry;
import org.jdbi.v3.core.mapper.ColumnMapper;
import org.jdbi.v3.core.statement.StatementContext;
import java.sql.Types;
import java.sql.ResultSet;
import java.sql.SQLException;

public class BooleanTypeConverter implements ColumnMapper<Boolean>, ArgumentFactory<Boolean> {

    // 处理从数据库读取到Java Boolean
    @Override
    public Boolean map(ResultSet r, int columnIndex, StatementContext ctx) throws SQLException {
        Object value = r.getObject(columnIndex);
        if (value == null) {
            return null;
        }
        if (value instanceof Byte) {
            return ((Byte) value) == 1;
        } else if (value instanceof byte[]) {
            byte[] bytes = (byte[]) value;
            return bytes.length > 0 && bytes[0] == 1;
        } else if (value instanceof Integer) {
            return ((Integer) value) == 1;
        }
        return Boolean.parseBoolean(value.toString());
    }

    // 处理从Java Boolean写入数据库
    @Override
    public Argument build(Boolean value, ConfigRegistry config) {
        return (pos, stmt, ctx) -> stmt.setInt(pos, value ? 1 : 0);
    }
}

然后把这个转换器注册到你的JDBI实例或者Handle上：

Jdbi jdbi = Jdbi.create(dataSource);
jdbi.registerColumnMapper(new BooleanTypeConverter());
// 或者在Handle层面注册
Handle handle = jdbi.open();
handle.registerColumnMapper(new BooleanTypeConverter());

如果用DAO接口的方式，还可以在DAO类上加上@RegisterColumnMapper(BooleanTypeConverter.class)注解，更方便维护。

2. 修改JDBC连接URL（快速生效的方案） #

直接在MySQL的JDBC连接URL里添加参数，让驱动自动把TINYINT(1)和BIT(1)映射成Java Boolean：

jdbc:mysql://localhost:3306/your_database?tinyInt1isBit=false&transformedBitIsBoolean=true

• tinyInt1isBit=false：告诉驱动不要把TINYINT(1)当成BIT类型处理，而是作为普通整数，之后会自动转成Boolean
• transformedBitIsBoolean=true：让驱动把BIT(1)类型直接转换成Boolean

这个方法不需要改代码，适合快速解决问题，注意确认你的mysql-connector-java版本（5.x和8.x都支持这两个参数）。

3. 在SQL查询中显式转换（临时应急方案） #

如果不想改代码或配置，可以直接在查询SQL里把字段转换成布尔值：

SELECT 
    CAST(is_hdfs_mapping AS UNSIGNED) AS is_hdfs_mapping,
    CASE WHEN is_active = 1 THEN TRUE ELSE FALSE END AS is_active
FROM billing_rate_mapping
...

或者针对BIT(1)字段用：

SELECT 
    CASE WHEN is_hdfs_mapping = b'1' THEN TRUE ELSE FALSE END AS is_hdfs_mapping,
    is_active
FROM billing_rate_mapping
...

这种方式适合临时调试，但长期维护建议用前两种方案，避免SQL里到处都是转换逻辑。

额外注意点 #

空指针异常通常是因为JDBI找不到合适的转换器，导致返回null，业务代码调用时没有判空触发的。所以不管用哪种方案，都要确保转换器覆盖到BIT(1)和TINYINT(1)两种类型，或者URL参数确实生效了。

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