独立Redis节点出现CROSSSLOT错误的排查与解决请求

核心原因 #

CROSSSLOT错误本来是Redis集群模式下，多key操作的key哈希到不同槽位才会触发的，但你的Redis是单节点且已禁用集群，问题大概率出在客户端错误启用了集群模式，或是Redis实际未正确禁用集群模式。

排查步骤与解决方法 #

1. 先确认Redis实际运行模式 #

进入Redis Pod，执行命令检查集群模式是否真的被禁用：

# 进入目标Pod
kubectl exec -it <redis-pod-name> -- /bin/sh
# 登录Redis（用环境变量里的密码）
export REDISCLI_AUTH=$REDIS_AUTH
redis-cli -h localhost -p 6379
# 查看集群状态
info cluster

如果输出里cluster_enabled的值是1，说明集群模式没被正确禁用，按下面的方式修复：

• 检查ConfigMap挂载：进入Pod查看/tmp/conf/redis.conf的内容，确认里面确实有cluster-enabled no。如果内容不对，检查ConfigMap的创建是否正确，或是挂载路径有没有写错。
• 强制在启动命令里加禁用参数：修改Deployment的command为：

  redis-server /tmp/conf/redis.conf --cluster-enabled no --requirepass $REDIS_AUTH
  

  Redis的命令行参数优先级高于配置文件，这样能确保集群模式被强制关闭。

2. 修正Spring Boot客户端配置 #

如果Redis确实是单节点，Spring Boot必须用单节点连接配置，绝对不能配置集群相关参数：

• 错误配置（会触发集群模式连接，直接导致CROSSSLOT）：

  # 这些配置必须删掉！
  spring.data.redis.cluster.nodes=redis-standalone:6379
  spring.data.redis.cluster.max-redirects=3
  

• 正确的单节点配置：

  spring.data.redis.host=redis-standalone
  spring.data.redis.port=6379
  spring.data.redis.password=<你的Redis密码>
  # Lettuce客户端默认配置即可，不需要额外集群相关设置
  

• 如果是用Java代码配置Redis连接，确保创建的是RedisStandaloneConfiguration，而非RedisClusterConfiguration：

  @Bean
  public RedisConnectionFactory redisConnectionFactory() {
      RedisStandaloneConfiguration config = new RedisStandaloneConfiguration();
      config.setHostName("redis-standalone");
      config.setPort(6379);
      config.setPassword(RedisPassword.of("<你的Redis密码>"));
      return new LettuceConnectionFactory(config);
  }
  

3. 额外检查点 #

• 确认Redis镜像默认配置：有些自定义Redis镜像可能默认开启集群模式，要确保你的配置能覆盖这个默认值。
• 查看Redis启动日志：执行kubectl logs <redis-pod-name>，搜索cluster-enabled，确认启动时加载的参数是no。

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