Spring Boot中ItemMedium实体查询无返回结果问题排查

以下是几个常见的排查点，逐一核对就能定位问题：

• 数据库表本身无数据
  直接登录数据库，执行SELECT * FROM ITEM_MEDIUM;语句，确认表中是否存在数据。如果表是空的，查询自然返回空数组。

• 实体类与数据库映射不匹配

  • 检查表名映射：@Entity(name = "ITEM_MEDIUM")指定的表名是否和数据库中实际的表名完全一致（注意Oracle等数据库区分大小写，MySQL默认不区分，但如果表名创建时加了引号也会区分）。
  • 检查字段映射：JPA默认采用驼峰转下划线的命名策略，但如果数据库列名和实体字段的映射关系不对，会导致查询不到数据。比如实体的itemMediumId对应数据库的ITEM_MEDIUM_ID，如果没有配置正确的命名策略，或者没有用@Column明确指定列名，可能出现映射错误。另外，@JsonProperty仅用于JSON序列化，不影响JPA和数据库的映射，别搞混了。
  • 检查序列配置：虽然序列ITEM_MEDIUM_SEQ主要影响数据插入，但如果序列不存在或配置错误，会导致插入数据失败，间接造成表为空。

• Repository查询逻辑错误

  • 确认Repository接口正确继承了JpaRepository<ItemMedium, Long>（或其他Spring Data Repository父接口），没有写错泛型类型。
  • 检查查询方法：如果用的是自定义@Query注解，确认SQL语句是否正确，有没有误加过滤条件；如果用方法名推导查询（比如findAllBy...），别不小心加了额外的筛选条件导致返回空。
  • 检查全局过滤器：如果项目中配置了JPA过滤器（比如软删除的@Filter），会自动给所有查询加上过滤条件（如ARCHIVE_STATUS = 'NORMAL'），如果数据库中的数据不符合该条件，就会返回空。

• 事务与数据源问题

  • 如果是插入数据后立即查询，确认插入操作所在的事务已经提交，未提交的事务不会将数据写入数据库。
  • 检查数据源配置：确认Repository连接的数据库和你手动查看的是同一个，避免查错数据库的情况。

• JSON序列化异常（看似空数组，实际有数据）
  这种情况较少见，但如果实体类的@Getter注解失效，或者Date类型字段序列化失败，可能导致返回的JSON异常。此时可以查看后端日志，是否有序列化报错，或者在代码中打印查询结果，确认是否真的查询到了数据。

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