Spring Boot Data JPA空查询结果下避免NPE并返回空字符串

方案1：SQL层面直接返回默认空值 #

在原生SQL中通过数据库内置函数处理空值，确保即使无匹配结果也返回一行填充空字符串的数据，避免投影对象为null。

以MySQL为例，原SQL：

SELECT name, email FROM profile WHERE customer_id = ?1

修改后：

SELECT IFNULL(name, '') AS name, IFNULL(email, '') AS email 
FROM profile WHERE customer_id = ?1
UNION ALL
SELECT '', '' WHERE NOT EXISTS (SELECT 1 FROM profile WHERE customer_id = ?1)

其他数据库可替换对应函数：PostgreSQL用COALESCE，Oracle用NVL。这样无论是否有匹配数据，都会返回一行结果，投影对象能正常实例化，调用get方法时直接得到空字符串。

方案2：Repository层包装返回值并处理空对象 #

将Repository方法的返回值改为Optional，再通过默认方法或业务层逻辑返回填充空字符串的默认投影对象。

1. 修改Repository方法：

public interface ProfileRepository extends JpaRepository<Profile, Long> {
    @Query(value = "SELECT name, email FROM profile WHERE customer_id = ?1", nativeQuery = true)
    Optional<ProfileView> findByCustomerId(Long customerId);
}

2. 添加默认方法处理空值：

default ProfileView findByCustomerIdWithDefault(Long customerId) {
    return findByCustomerId(customerId)
            .orElseGet(() -> new ProfileView() {
                @Override
                public String getName() {
                    return "";
                }

                @Override
                public String getEmail() {
                    return "";
                }
            });
}

调用findByCustomerIdWithDefault()时，无匹配结果会自动返回填充空字符串的投影实例，不会触发NPE。

方案3：利用Spring Data ProjectionFactory创建默认投影 #

如果ProfileView是接口类型投影，可通过ProjectionFactory快速生成填充空字符串的默认实例。

在Service层实现：

@Service
public class ProfileService {
    private final ProfileRepository profileRepository;
    private final ProjectionFactory projectionFactory;

    public ProfileService(ProfileRepository profileRepository, ProjectionFactory projectionFactory) {
        this.profileRepository = profileRepository;
        this.projectionFactory = projectionFactory;
    }

    public ProfileView getProfileView(Long customerId) {
        ProfileView view = profileRepository.findByCustomerId(customerId);
        if (view == null) {
            return projectionFactory.createProjection(ProfileView.class, Map.of(
                    "name", "",
                    "email", ""
            ));
        }
        return view;
    }
}

此方式无需手动编写投影实现类，适合接口类型的投影场景。

补充说明 #

• 若ProfileView是普通Java类（类投影），方案2中可直接实例化该类并给所有字段赋值为空字符串。
• 不同数据库的空值处理函数存在差异，编写SQL时需对应调整。

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