Spring Boot使用JPA查询用户表时处理数据库空值问题

这个问题我之前踩过一模一样的坑，本质就是Java基本类型没办法存储null值搞出来的：你的User实体里phone字段用了基本类型long，但数据库里存在手机号为null的记录，JPA尝试把null赋值给long类型字段时，直接就触发了IllegalArgumentException。

下面给你几个实用的解决方案，按推荐优先级排序：

1. 将字段类型改为包装类Long #

这是最直接也最符合Java规范的做法，包装类天生支持存储null值。修改你的实体类代码就行：

// 原来的代码
// private long phone;

// 修改后的代码
private Long phone;

这样JPA会自动把数据库中的null值映射成Long类型的null，完全不会再报错。如果业务上允许手机号为空，这个方案绝对是首选。

2. 给数据库字段设置默认值（结合JPA注解） #

要是你不想改动实体类的字段类型，可以在数据库层面给phone字段设个默认值，同时在JPA注解里明确配置：

@Column(name = "phone", columnDefinition = "BIGINT DEFAULT 0")
private long phone;

这样数据库里的null值会被自动替换成0，JPA映射时就能正常赋值给long类型了。不过要注意：业务场景里能不能用0来代表“无手机号”，别给后续逻辑埋坑。

3. 查询时用JPQL函数处理null值 #

如果既不能改实体类，也动不了数据库结构，那就在查询语句里用COALESCE函数把null转成默认值：

// 查询所有时处理null的示例
String jpql = "SELECT u.id, u.name, COALESCE(u.phone, 0) FROM User u";

COALESCE函数会返回第一个非null的值，这里把null的手机号替换成0，刚好适配long类型的接收逻辑。

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