必须用reactiveredistemplate配合lettuceconnectionfactory，禁用jedis；key/value序列化器需显式设置为stringredisserializer等响应式兼容类型，避免隐式阻塞。
因为用了阻塞式客户端或错误的模板，不是响应式栈的一部分——RedisTemplate + JedisConnectionFactory 组合在 WebFlux 里必然阻塞，哪怕返回 Mono 也只是包装了同步调用。
用了 RedisTemplate 而不是 ReactiveRedisTemplate
常见错误是沿用 Spring MVC 的写法：定义一个 RedisTemplate Bean，然后在 WebFlux 控制器里调用 opsForValue().get("key")，再用 Mono.just() 包一层。这毫无意义：get() 方法本身是同步阻塞的，会卡住 Netty 的 EventLoop 线程。
- 必须删掉所有
@Bean public RedisTemplate redisTemplate(...)声明，换成ReactiveRedisTemplate -
ReactiveRedisTemplate的所有操作（如opsForValue().get()）返回的是Mono/Flux，底层走 Lettuce 的响应式连接，不占用事件循环线程 - 若项目中同时存在
RedisTemplate和ReactiveRedisTemplateBean，确保没被@Primary错误标记导致自动注入错对象
LettuceConnectionFactory 被 Jedis 替代或未生效
Spring Boot 2.0+ 默认启用 Lettuce，但很多项目因历史依赖或手动配置，实际运行的是 Jedis。Jedis 是纯同步阻塞客户端，无法适配响应式语义，哪怕你写了 ReactiveRedisTemplate，只要底层连的是 Jedis，照样阻塞。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 检查依赖树：
mvn dependency:tree | grep redis，确认没有spring-boot-starter-data-redis-jedis或显式引入jedisjar - 启动日志搜索
LettuceConnection或JedisConnection，看到后者就说明被替换了 - 若曾手动定义
JedisConnectionFactoryBean，必须彻底删除；Lettuce 连接工厂由RedisAutoConfiguration自动装配，无需手写
序列化器没设对，触发隐式阻塞反序列化
ReactiveRedisTemplate 默认用 JdkSerializationRedisSerializer，它在反序列化时会执行反射和字节码还原，CPU 密集且不可取消——这不是网络 I/O，但一样会拖慢 Mono 链，尤其在 value 是大对象时。
- key 必须用
StringRedisSerializer，否则get("user:100")查不到数据（序列化后 key 变成乱码字节数组） - value 推荐用
GenericJackson2JsonRedisSerializer，比 JDK 序列化快 3～5 倍，且不触发类加载器锁 - 必须显式调用
setKeySerializer()和setValueSerializer()，只设setDefaultSerializer()不生效 - 如果 value 是简单字符串，直接用
StringRedisSerializer，避免 JSON 解析开销
误用 execute() 或 executePipelined() 回到阻塞路径
想执行 Lua 脚本或管道命令时，有人直接传 RedisCallback 给 execute()，这是响应式 API 里的“后门”：它会把回调提交到 Lettuce 内部的线程池（非 Netty EventLoop），破坏背压、丢失上下文，且无法被 timeout() 正确中断。
- 正确做法是通过
reactiveRedisTemplate.getConnectionFactory().getReactiveConnection()拿到ReactiveRedisConnection - 用
connection.eval()、connection.pipelined()等原生命令方法，它们返回Mono，全程在响应式链内流转 - 管道操作要链式组合：
connection.pipelined().map(...).flatMap(...)，不能攒一堆命令再exec() - Lua 脚本内禁止耗时计算（比如遍历万级数组），Redis 单线程模型下，脚本卡住 = 整个实例卡住
最易被忽略的一点：即使所有代码都用了 ReactiveRedisTemplate，只要连接池配置不当（如 max-active 过小 + max-wait 过短），也会在获取连接时触发线程阻塞等待——这不是命令执行阻塞，而是连接复用环节的资源争抢，同样会让 Mono 流延迟甚至超时。
