RedisCommandExecutionException: ERR unknown command ‘LPOS‘

场景：因为代码中使用了 Redis 的 List，然后判断某个元素是否在 List 中存在，结果报错：ERR unknown command ‘LPOS‘

这个错误表明 Redis 服务器无法识别 LPOS 命令。LPOS 是 Redis 6.0.6 及以上版本引入的新命令，用于查找元素在列表中的位置。如果 Redis 服务器版本低于 6.0.6，就会报此错误。

Long index = redisTemplate.opsForList().indexOf("Test_Key", templateId.toString());
if (index < 0) {return true;
}
return false;

---

解决方案

1. 升级 Redis 服务器（只能说尽可能）

将 Redis 升级到 6.0.6 或更高版本，以支持 LPOS 命令。

• 检查当前 Redis 版本：

redis-cli info | grep redis_version

• 升级 Redis：

# Ubuntu / Debian
sudo apt update && sudo apt install redis-server# CentOS / RHEL
sudo yum install epel-release
sudo yum install redis

---

如果升级了 Redis 还不能用，则还还需要检查 Spring Data Redis 版本是否支持 LPOS：

确保 Spring Data Redis 与 Redis 版本匹配。indexOf() 方法是在 Spring Data Redis 2.7.0+ 才引入的：

<!-- Maven 示例 -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId><version>2.7.0</version>
</dependency>

• Spring Data Redis 的 indexOf() 方法内部使用 LPOS，但不会主动校验 Redis 版本，可能导致兼容性问题。

---

2. 使用 LINDEX + 遍历查找（兼容旧版 Redis）

如果不能升级 Redis，可手动遍历列表模拟 indexOf 行为：

public Long customIndexOf(String key, String value) {Long size = redisTemplate.opsForList().size(key);if (size == null || size == 0) {return -1L;}for (long i = 0; i < size; i++) {String element = redisTemplate.opsForList().index(key, i);if (value.equals(element)) {return i;}}return -1L;
}// 原代码（需要 Redis 6.2+ 支持 LPOS）
Long index = redisTemplate.opsForList().indexOf(key, value);// 兼容旧版 Redis 的替代方案
Long index = customIndexOf(key, value);

---

3. 使用 Set / Hash 数据结构替代 List（推荐）

如果业务场景中频繁查找元素位置，使用 Set 或 Hash 替代 List 更高效、可维护：

3.1 使用 Set（集合）

Redis 的 Set 是无序集合，自动去重，支持高效的包含判断（底层为哈希表）。

优点： 查询是否存在的操作时间复杂度为 O(1)；API 简单，适合只关心“是否存在”的场景；自动去重。

// 添加元素
redisTemplate.opsForSet().add("mySet", "value1");// 判断元素是否存在
Boolean exists = redisTemplate.opsForSet().isMember("mySet", "value1");if (Boolean.TRUE.equals(exists)) {System.out.println("元素存在");
} else {System.out.println("元素不存在");
}

3.2 使用 Hash（散列结构）

Redis 的 Hash 是键值对结构，适用于有“key-value”对应关系的场景。如果希望记录一些额外信息（如：索引、时间戳等），可以使用 Hash。

优点： 同样是 O(1) 的查找性能；可存储额外信息；支持更新和删除特定字段。

// 添加元素及其索引（或其他信息）
redisTemplate.opsForHash().put("myHash", "value1", "index_5");// 判断元素是否存在
Boolean exists = redisTemplate.opsForHash().hasKey("myHash", "value1");if (Boolean.TRUE.equals(exists)) {System.out.println("元素存在于 Hash 中");
} else {System.out.println("元素不存在");
}