2. Redis错误码体系概述：常见Redis错误码分类

在搜索服务的集成测试中，Redis作为缓存层和会话存储层，其错误码的准确断言是验证系统健壮性的关键环节。Redis错误码体系遵循“前缀+数字”的规范结构，通过错误前缀即可快速定位故障域。本章系统梳理集成测试中最常遇到的四类Redis错误码，为后续断言策略奠定基础。

2.1 错误码分类总览

Redis错误码按故障来源可分为连接错误、超时错误、数据错误和命令错误四大类。下表列出了各类的核心特征与典型错误码：

2.2 连接错误

连接错误发生在客户端与Redis服务器建立或维持TCP连接的过程中。在搜索服务中，当Redis连接池配置不当或网络分区发生时，此类错误会频繁出现。

• NOAUTH：未提供密码或密码错误。测试中应验证搜索服务启动时是否携带正确的requirepass。
• READONLY：向只读副本执行写操作。搜索服务的缓存写入逻辑必须路由到主节点。
• MASTERDOWN：主节点宕机且无自动故障转移。集成测试应模拟主节点不可用，验证服务是否触发降级。
• CLUSTERDOWN：集群模式中部分哈希槽不可用。测试需覆盖集群分片故障场景。

// 集成测试中连接错误断言示例（Java + Jedis）
try {
    jedis.set("search:query:test", "result");
} catch (JedisNoAuthException e) {
    assertTrue(e.getMessage().contains("NOAUTH"));
    // 验证服务已记录认证失败日志并触发重连
} catch (JedisConnectionException e) {
    assertTrue(e.getMessage().contains("Connection refused"));
    // 验证服务已切换至本地缓存降级
}

2.3 超时错误

超时错误是搜索服务集成测试中最需要关注的性能类错误。Redis客户端通过connectTimeout、readTimeout和poolMaxWait三个参数控制超时行为。

2.4 数据错误

数据错误源于对Redis数据结构的误操作或资源限制。搜索服务中，缓存键的类型管理和内存水位监控是预防此类错误的关键。

• WRONGTYPE：对已存在的键执行了不兼容的操作。例如，将一个Hash类型的缓存键当作List来LPUSH。测试中应使用TYPE命令前置校验。
• OOM：内存使用超过maxmemory限制，且淘汰策略无法释放空间。集成测试应构造大键场景，验证服务是否触发OOM并优雅降级。
• LOADING：Redis正在加载持久化文件（RDB/AOF），暂时无法服务。测试需模拟重启加载阶段，验证搜索请求是否被缓存穿透保护拦截。

// 数据错误断言：WRONGTYPE
try {
    // 假设缓存键 "search:hot:list" 已被设置为 String 类型
    jedis.lpush("search:hot:list", "item1");
} catch (JedisDataException e) {
    assertTrue(e.getMessage().startsWith("WRONGTYPE"));
    // 验证服务已清除错误缓存键并重建
}

2.5 命令错误

命令错误通常由客户端发送了Redis不支持的指令或参数格式错误引起。在搜索服务的集成测试中，这类错误多出现在Lua脚本和Stream消费组的使用场景。

2.6 错误码分类关系图

下图展示了四类Redis错误码在搜索服务集成测试中的层次关系与典型断言路径：

2.7 错误码断言优先级矩阵

在搜索服务的集成测试中，不同错误码的断言优先级不同。下表给出了基于影响范围和发生频率的优先级排序：