Spring Data JPA仓库Query注解email参数失效，SQL显示?的问题

首先明确：你看到的SQL里的?是预编译SQL的占位符，这是JPA/Hibernate的正常行为，并非参数未替换——实际执行时框架会自动把你传入的email值绑定到这个占位符，避免SQL注入。如果你的查询没返回预期结果，从以下几个方向排查：

1. 检查实体类与数据库字段的映射 #

确保Users实体类的email字段和数据库表users的email字段映射正确：

• 实体类的email字段是否加了@Column注解？如果数据库字段名和实体属性名不一致（比如数据库是user_email但实体是email），需要指定name属性：@Column(name = "user_email")
• 字段类型是否匹配？比如数据库是VARCHAR，实体是String，确保没有类型不兼容的情况

2. 验证传入的参数值 #

• 检查调用getAllByEmail时传入的email值是否正确，有没有空格、大小写问题？比如数据库里是test@example.com，你传入的是Test@Example.com，不同数据库对大小写的处理规则不同（MySQL默认不区分，PostgreSQL默认区分）
• 可以在服务类方法里临时加日志打印参数，确认传入值：

public List<Users> getAllByEmail(String email) {
    System.out.println("传入的email参数：" + email); // 或用项目日志框架打印
    return userRepository.findUserByEmail(email);
}

3. 开启参数绑定日志，确认参数是否正确传递 #

在application.properties（或application.yml）中添加日志配置，查看实际绑定的参数值：

application.properties #

logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

application.yml #

logging:
  level:
    org.hibernate.SQL: DEBUG
    org.hibernate.type.descriptor.sql.BasicBinder: TRACE

开启后，日志会输出类似内容：

binding parameter [1] as [VARCHAR] - [test@example.com]

这样能直接确认绑定的参数值是否正确。

4. 简化查询，排除自定义Query的问题 #

暂时不用自定义@Query，改用Spring Data JPA的方法名推导功能，替换仓库方法：

List<Users> findByEmail(String email);

如果这个方法能正常查询，说明之前的自定义@Query可能存在拼写错误——检查@Query里的Users是否是实体类的正确类名，u.email是否是实体类的正确属性名。

5. 检查事务或缓存问题 #

• 如果查询方法在事务中，之前的操作可能修改了数据但未提交，导致查询不到最新数据
• 检查是否开启了二级缓存，若缓存中有旧数据，可能影响查询结果

内容的提问来源于stack exchange，提问作者Hoàng Thiện