PostgreSQL枚举字段存NULL值查询时Java报错的解决问询

一、自定义枚举转换器处理NULL值 #

默认的@Enumerated注解在映射NULL值时，底层可能因强制调用valueOf()抛出异常。你可以通过实现AttributeConverter自定义转换逻辑，让NULL值直接返回NULL：

1. 创建转换器类：

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;

@Converter(autoApply = true) // 自动应用到所有FishDomain类型的字段
public class FishDomainConverter implements AttributeConverter<FishDomain, String> {

    @Override
    public String convertToDatabaseColumn(FishDomain attribute) {
        return attribute == null ? null : attribute.name();
    }

    @Override
    public FishDomain convertToEntityAttribute(String dbData) {
        return dbData == null ? null : FishDomain.valueOf(dbData);
    }
}

2. 移除DTO中fish_domain字段的@Enumerated注解（转换器优先级更高，保留注解也不影响）：

public class MyFishDTO {
    private FishDomain fishDomain;
    // 其他字段...
}

这样数据库中fish_domain为NULL时，查询会直接映射为DTO中的NULL值，不会触发异常。

二、在SQL查询中处理NULL值 #

如果要在SQL层面显式处理NULL，可以用CASE WHEN确保返回值要么是枚举有效值，要么是NULL（仍需配合上面的转换器才能避免异常）：

修改原生查询语句：

@Query(value = "SELECT ft.id, ft.name, " +
               "CASE WHEN ft.fish_domain IS NULL THEN NULL ELSE ft.fish_domain END AS fish_domain, " +
               "/* 列出其他需要查询的字段 */ " +
               "FROM fish_table ft WHERE ft.name = :fishName", nativeQuery = true)
MyFishDTO getMyFishByName(@Param("fishName") String fishName);

注意：所谓“排除该字段”不可行——DTO是固定结构，JPA必须映射所有定义的字段。如果需要动态返回字段，可改用Map<String, Object>或自定义投影类，但会增加复杂度。

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