3. Redis基础回顾：常用数据结构、命令、连接方式、错误码分类

在契约测试中，对Redis错误码的断言依赖于对Redis底层通信机制的准确理解。本节系统梳理Redis的核心数据结构、操作命令、连接模式及错误码体系，为后续构建搜索服务的契约测试用例奠定基础。

3.1 常用数据结构与适用场景

Redis提供多种数据结构，搜索服务中高频使用的包括以下五种：

3.2 核心命令分类与错误码映射

Redis命令按功能分为五类，每类命令在契约测试中对应不同的错误码断言策略：

• 键管理命令： DEL、EXISTS、EXPIRE、TTL — 错误码多为 WRONGTYPE（类型不匹配）或 NOSCRIPT（脚本不存在）。
• 字符串命令： GET、SET、INCR、MGET — 常见错误码 WRONGTYPE、OOM（内存不足）。
• 哈希命令： HGET、HSET、HGETALL — 错误码 WRONGTYPE、NOSCRIPT。
• 集合命令： SADD、SMEMBERS、SINTER — 错误码 WRONGTYPE、BUSYGROUP（流消费组冲突）。
• 有序集合命令： ZADD、ZRANGE、ZREVRANK — 错误码 WRONGTYPE、MIN/MAX 参数格式错误。

# 契约测试中典型的错误码断言示例（伪代码）
# 对Hash类型执行List命令，期望返回WRONGTYPE
> LPUSH doc:123 "value"
(error) WRONGTYPE Operation against a key holding the wrong kind of value

# 内存超限时写入失败
> SET cache:key "large_value"
(error) OOM command not allowed when used memory > 'maxmemory'

3.3 连接方式与通信协议

Redis支持三种连接方式，每种方式在契约测试中影响错误码的传输格式：

3.4 错误码分类体系

Redis错误码按来源分为六大类，契约测试中需针对每类设计不同的断言逻辑：

1. 语法错误（-ERR）： 命令格式错误、参数数量不对。例如 ERR wrong number of arguments for 'get' command。
2. 类型错误（-WRONGTYPE）： 对错误的数据结构执行操作。搜索服务中常见于误用Hash/List命令。
3. 权限/认证错误（-NOAUTH / -NOPERM）： 未认证或ACL权限不足。契约测试需模拟认证失败场景。
4. 资源限制错误（-OOM / -LOADING）： 内存超限或持久化加载中。搜索服务高并发时易触发。
5. 集群重定向错误（-MOVED / -ASK）： 槽位迁移或重分配。契约测试需验证客户端重试逻辑。
6. 主从错误（-READONLY / -MASTERDOWN）： 从节点只读或主节点宕机。搜索服务读多写少场景需覆盖。

3.5 Redis通信协议与错误码传输机制

下图展示了RESP2协议下错误码的传输链路，以及契约测试中如何捕获并断言错误码：

3.6 契约测试中的错误码断言策略

基于上述分类，在搜索服务的契约测试中，建议采用以下断言策略：

• 精确匹配： 对 WRONGTYPE、OOM 等确定性错误码，使用字符串精确匹配。
• 前缀匹配： 对 ERR 类错误（如参数错误），使用前缀匹配 -ERR 并验证错误描述中的关键词。
• 重定向忽略： 在Cluster模式下，契约测试应忽略 MOVED 和 ASK 错误码，转而验证客户端是否成功重试并返回正确结果。
• 超时与连接错误： 网络层面的超时错误（如 ETIMEDOUT）不属于Redis错误码，契约测试需单独设计超时断言逻辑。

// 契约测试中错误码断言示例（Java + Jedis）
@Test
void testWrongTypeError() {
    try {
        jedis.lpush("hashKey", "value");  // 对Hash类型执行List命令
        fail("Expected WRONGTYPE error");
    } catch (JedisDataException e) {
        assertTrue(e.getMessage().startsWith("WRONGTYPE"));
        assertEquals("Operation against a key holding the wrong kind of value",
                     e.getMessage().substring(10));
    }
}

@Test
void testClusterRedirect() {
    // 契约测试不直接断言MOVED，而是验证重试后的结果
    String result = clusterJedis.get("key_on_another_slot");
    assertNotNull(result);
    assertEquals("expected_value", result);
}