基于包含子句的JPA实体查询无法返回结果问题求助

先明确核心问题点，再逐一排查：

1. 修正方法返回类型（最可能的直接原因） #

你的查询方法返回类型Page<List<Country>>存在错误：

• Page接口本身已封装分页后的实体集合，正确返回类型应为Page<Country>，错误的嵌套集合类型会导致JPA无法正确映射查询结果，直接返回空分页对象。

修正后的方法签名：

Page<Country> findByStateAndCityContainingIgnoreCase(String state, String city, Pageable pageable);

2. 检查实体类映射正确性 #

确保Country实体的注解配置与数据库表完全匹配：

• 类上必须添加@Entity注解，且@Table(name = "countries")指定正确表名（注意部分数据库如PostgreSQL区分表名大小写）。
• state和city字段需添加@Column注解，保证列名与数据库中列名一致，避免因列名不匹配导致WHERE条件失效。
• JPA实体必须包含主键字段，你的原实体类缺少主键，这也会引发查询异常。

示例正确实体类：

@Entity
@Table(name = "countries")
public class Country {
    @Id
    private Long id; // 必须添加主键
    
    @Column(name = "state")
    private String state;
    
    @Column(name = "city")
    private String city;
    
    // 构造方法、getter/setter省略
}

3. 验证参数与数据库数据 #

• 确认传入的state参数与数据库中的值完全一致（精确匹配要求无空格、大小写完全对应）。
• 检查数据库中是否存在符合条件的数据：即state等于指定值，且city包含目标关键词（不区分大小写，比如"Chicago"、"Chengdu"均应匹配）。

4. 开启SQL日志排查生成语句 #

在配置文件中开启JPA的SQL打印，直接验证生成的查询是否符合预期：

• Spring Boot项目可在application.properties中添加：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.properties.hibernate.use_sql_comments=true

查看控制台输出的SQL，确认：

• WHERE条件是否正确生成state = ?和LOWER(city) LIKE ?（ContainingIgnoreCase会自动处理大小写和通配符）。
• 绑定的参数值是否与传入值一致，确认city参数是否被自动添加%前缀和后缀。

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