spring boot 使用 spring data redis 时，`crudrepository` 对 `boolean` 类型字段（如 `isactive`）的派生查询（如 `findallbyactivefalse()`）常因序列化/反序列化不一致而返回空结果；根本原因是 redis 存储的布尔值被序列化为字符串 `"true"`/`"false"`，但默认查询仍按 `boolean` 类型匹配，导致类型不匹配。
在 Spring Data Redis 中，@RedisHash 实体的字段默认通过 JdkSerializationRedisSerializer（或 GenericJackson2JsonRedisSerializer，取决于配置）进行序列化。当使用 Jackson 序列化时，boolean 字段（如 private boolean isActive;）会被转为 JSON 字符串 "true" 或 "false"；而 Spring Data Redis 的派生查询机制（如 findByActiveFalse）底层尝试将 false 参数作为 Java boolean 值去匹配 Redis 中存储的字符串形式 "false"，由于类型不一致（Boolean vs String），无法正确匹配索引或执行扫描过滤，最终返回空列表。
✅ 正确做法是：将查询方法参数改为 String 类型，并显式传入 "true" 或 "false" 字符串：
@Repository
public interface StateDataCacheRepository extends CrudRepository<StateDataCache, String> {
// ✅ 推荐：按字符串值查询（与实际序列化格式一致）
List<StateDataCache> findAllByActive(String active);
// ✅ 或使用自定义 JPQL 风格查询（需启用 @Query 支持）
@Query("SELECT * FROM StateDataCache WHERE active = ?0")
List<StateDataCache> findByActiveAsString(String active);
// ❌ 不推荐：以下方法在默认配置下通常失效
// List<StateDataCache> findAllByActiveFalse();
// List<StateDataCache> findAllByActiveIs(boolean active);
}调用示例：
// 正确调用方式
List<StateDataCache> inactiveList = repository.findAllByActive("false");
List<StateDataCache> activeList = repository.findAllByActive("true");? 补充建议：
-
统一序列化策略：若项目中已使用 GenericJackson2JsonRedisSerializer（推荐），请确保 RedisTemplate 配置正确：
@Bean public RedisTemplate<String, Object> redisTemplate() { RedisTemplate<String, Object> template = new RedisTemplate<>(); template.setConnectionFactory(redisStandAloneConnectionFactory()); ObjectMapper objectMapper = new ObjectMapper(); objectMapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY); objectMapper.activateDefaultTyping(LazyPolymorphicTypeValidator.noLazyChecks(), ObjectMapper.DefaultTyping.NON_FINAL); GenericJackson2JsonRedisSerializer serializer = new GenericJackson2JsonRedisSerializer(objectMapper); template.setDefaultSerializer(serializer); template.setKeySerializer(new StringRedisSerializer()); template.setValueSerializer(serializer); template.setHashKeySerializer(new StringRedisSerializer()); template.setHashValueSerializer(serializer); return template; } 避免依赖派生查询的布尔逻辑：Spring Data Redis 的派生查询对非字符串/数值型字段（如 boolean、LocalDateTime、枚举）支持有限，生产环境建议优先使用 @Query + JSONPath（Lettuce 6.1+ 支持）或业务层内存过滤（适用于数据量较小场景）。
-
验证存储内容：可通过 Redis CLI 检查实际存储值：
HGETALL "StateData:123" # 输出类似：1) "id" 2) "123" 3) "deviceId" 4) "dev-001" ... 7) "active" 8) "false"
确认 active 字段确为字符串 "false" 而非二进制布尔字节，可排除序列化器误配问题。
总结：Spring Data Redis 中布尔字段查询失败本质是「序列化表示」与「查询解析类型」错配。绕过派生查询限制最稳定的方式是将查询参数声明为 String 并传入 "true"/"false"，同时确保序列化器配置统一、可预测。
