Spring Boot 3对接Oracle时char(1)空值转boolean抛SQL异常的解决问询

针对Spring Boot 3 + Oracle场景下，char(1)字段（存0、1、空值）映射Java boolean字段时的JDBC转换异常，提供以下几种可行方案：

方案一：自定义JPA属性转换器（推荐） #

通过实现JPA的AttributeConverter接口，手动控制Java boolean与数据库char(1)的转换逻辑，覆盖空值场景的处理：

1. 编写转换器类：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;

@Converter(autoApply = true) // 全局生效，无需每个字段单独指定
public class BooleanToCharConverter implements AttributeConverter<Boolean, String> {

    @Override
    public String convertToDatabaseColumn(Boolean attribute) {
        // 将Java boolean转为数据库存储的char值
        return attribute != null && attribute ? "1" : "0";
    }

    @Override
    public Boolean convertToEntityAttribute(String dbData) {
        // 处理数据库的char值，空值/空字符串统一返回false
        return "1".equals(dbData);
    }
}

2. 实体类字段调整：
   去掉@Column中的columnDefinition="boolean default false"，直接映射字段即可：

private boolean privatePhone = false; // 保留Java默认值，或依赖数据库默认值

优势：JPA标准实现，全局统一处理所有boolean转char(1)的场景，代码侵入性低，彻底解决空值转换异常。

方案二：用String字段接收+封装boolean访问方法 #

绕开JDBC的boolean自动转换，直接用String类型接收数据库的char(1)值，再通过封装方法对外提供boolean接口：

@Column(name = "PRIVATE_PHONE", columnDefinition = "CHAR(1) DEFAULT '0'")
private String privatePhoneStr;

// 对外暴露的boolean访问方法
public boolean isPrivatePhone() {
    return "1".equals(privatePhoneStr);
}

public void setPrivatePhone(boolean privatePhone) {
    this.privatePhoneStr = privatePhone ? "1" : "0";
}

优势：实现简单，无需额外转换器，适合快速修复场景。

方案三：数据库层面+查询时处理空值 #

1. 确保数据库字段默认值设为'0'，从源头减少空值的产生；
2. 在JPQL查询时，用Oracle的NVL函数将空值替换为'0'，例如：

SELECT e FROM YourEntity e WHERE NVL(e.privatePhone, '0') = '1'

注意：此方案仅能处理查询场景，无法解决实体加载时的空值转换异常，仅作为辅助手段。

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