Native JPA原生查询无结果：数据库存在对应邮箱却返回null求助

我来帮你捋捋这个问题，这种情况我之前碰到好多次，通常是下面几个地方出了问题，你可以逐一排查：

• 大小写不匹配问题
  原生查询是直接把SQL传给数据库执行的，所以要注意数据库的大小写规则：

  • 如果是PostgreSQL、Oracle这类区分大小写的数据库，你的表名/字段名必须和数据库里的完全一致。比如你代码里写的是users，但数据库实际表名是Users（首字母大写），或者字段名是EMAIL而你写的是email，都会导致查不到数据返回null。
  • 另外邮箱字符串本身的大小写也要注意，比如数据库里存的是John@Example.com，但你传入的是john@example.com，如果数据库的collation设置为区分大小写，也会匹配失败。

• 参数传递有隐藏问题
  先确认你传入的email变量是不是和数据库里的记录完全一致：

  • 有没有可能变量里包含了多余的空格？比如"test@example.com "（末尾有空格），但数据库里的记录没有空格，这样查询自然返回null。可以先打印一下传入的email值，或者临时在SQL里加trim处理验证：SELECT u.* FROM users u WHERE TRIM(u.email) = TRIM(?1)（不过不推荐频繁用trim，先优先排查参数本身）。

• 实体类与数据库的映射问题
  虽然用了原生查询，但JPA需要把查询结果映射到User实体，如果映射失败也可能返回null：

  • 检查实体类的字段和数据库字段是否对应，比如实体里是userEmail但数据库里是email，有没有正确加@Column(name = "email")注解？
  • 确认实体类有没有公共的无参构造函数，JPA实例化实体时必须依赖这个，如果没有的话可能无法创建对象，最终返回null。
  • 主键映射是否正确？比如数据库主键是user_id，但实体里的@Id字段没指定@Column(name = "user_id")，导致JPA无法识别结果中的主键，进而无法正确返回实体。

• 数据库连接配置错误
  有没有可能你的应用连接的不是你以为的那个数据库？比如配置文件里的数据库URL写错了，连接到了测试库而不是生产库，或者数据库账号没有权限访问对应的表？你可以直接用应用的数据库账号登录数据库，执行同样的SELECT u.* FROM users u WHERE u.email = '你的邮箱值'语句，看看能不能查到记录。

• 事务或持久化上下文问题
  如果你的查询是在一个未提交的事务里，可能看不到其他事务提交的记录：

  • 比如在Spring环境下，自定义查询方法有没有加@Transactional注解？虽然CrudRepository的默认方法自带事务，但自定义原生查询有时候需要明确指定，尤其是涉及到只读操作时，可以加@Transactional(readOnly = true)试试。
  • 另外，如果在查询之前有对该用户记录的修改/删除操作但事务还没提交，也会导致查询不到最新的记录。

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