Spring JPA新增记录已入库但服务端接口查询不到问题排查

API 探路者

2026-8-27

Spring JPA 新增记录可在数据库查到但接口查询不到问题解决方案

em.refresh() 解决的是持久化上下文和数据库状态不一致的问题，和你当前遇到的场景完全不匹配，之前的排查方向完全错了。按以下优先级从高到低排查：

1. 最高发原因：查询存在隐式过滤条件

90%的同类问题都是这个原因导致的：

先打开Hibernate SQL日志，在配置文件添加以下配置：
```
spring:
  jpa:
    show-sql: true
    properties:
      hibernate:
        format_sql: true
```
调用查询接口时复制控制台打印的完整SQL，直接在数据库客户端执行，看能不能查到ID=601的记录。
如果SQL执行结果为空，检查SQL自动拼接的条件：
- 检查Book类上有没有加@Where、@Filter类注解，最常见的是软删除配置@Where(clause = "is_deleted = 0")：新增记录时如果没给is_deleted赋值，数据库中该字段值为null，无法匹配is_deleted=0的条件，存量数据因为历史逻辑默认赋值为0所以可以正常查询。
- 检查项目有没有配置全局JPA拦截器、Specification过滤器、多租户拦截器，这类组件会在所有查询SQL上自动拼接过滤条件，新增记录时如果对应过滤字段没赋值，就会被自动过滤。
你贴的Book实体中authorID、publisherID等外键字段都用了基本类型int，默认值为0，如果查询逻辑中存在类似authorID > 0的隐式条件，新增记录如果没手动给这些字段赋值，就会被过滤。

检查项目是否配置了多数据源、读写分离：如果写操作路由到写库，读操作路由到读库，主从同步中断、同步延迟都会导致写库能查到数据、读库查不到，存量数据因为已经完成同步所以可以正常查询。
你的createBook方法没有加@Transactional注解，虽然JpaRepository.save()本身自带事务，但如果方法内存在其他持久化逻辑，可能出现事务提交异常、数据源连接绑定错误的问题，给createBook加上@Transactional注解后再测试。

你写的通用Repository刷新逻辑根本没有生效：

自定义通用Repository接口必须加@NoRepositoryBean注解，避免Spring将其识别为普通Repository初始化报错。
必须在启动类的@EnableJpaRepositories注解上指定repositoryBaseClass = ElementRepositoryImpl.class，否则Spring Data JPA会默认用SimpleJpaRepository作为所有Repository的实现基类，你写的refresh()方法根本不会被调用。
额外提一句：save()方法执行成功、事务提交后，返回的实体对象已经和数据库状态一致，不需要额外调用refresh()，多余的调用反而可能因为事务上下文缺失抛出异常。

主键字段bookID使用了基本类型int，建议替换为包装类型Integer，基本类型默认值0会干扰JPA对实体未持久化状态的判断，虽然不是当前问题的直接诱因，但会埋下其他故障隐患。
直接查询数据库中ID=601的记录，核对除主键外的其他字段值是否和你传入的参数一致，如果存在字段为null/默认值，说明字段映射配置错误，查询时如果这些字段带过滤条件就会漏掉新记录。

第一步先打印实际执行的SQL，直接去数据库执行，这一步能定位90%的问题。
去掉createBook里多余的refresh()调用，给方法加上@Transactional再测试。
写一个最简单元测试，注入BookRepository，先调用save新增记录，立刻用返回的ID调用findById查询：
- 如果单元测试能查到，问题出在Web层拦截器、接口逻辑、数据源路由配置
- 如果单元测试查不到，问题出在JPA实体映射、事务、Repository核心配置

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