2. 搜索服务架构：整体架构图、服务间通信方式、Redis在搜索服务中的位置

搜索服务作为电商、内容平台或企业级应用的核心中间层，其架构设计直接影响查询性能、数据一致性与可观测性。本节从整体架构切入，逐步拆解服务间通信机制，并明确 Redis 在搜索链路中的关键定位。

2.1 搜索服务整体架构图

搜索服务通常采用 分层 + 异步管道 的架构模式，将数据写入、索引构建、查询路由与结果缓存解耦。下图展示了标准搜索服务的核心组件与数据流向：

2.2 服务间通信方式

搜索服务内部各层之间、以及搜索服务与外部依赖（如用户中心、商品中心）之间的通信，主要采用以下三种方式：

2.3 Redis 在搜索服务中的位置

Redis 在搜索架构中并非存储主路径，而是作为 加速层 和 协调层 存在。其具体职责可归纳为以下四个维度：

• 查询结果缓存： 对高频、低变更的搜索请求（如热门关键词、类目导航）进行结果缓存，TTL 通常设置为 30s～300s，命中率目标 > 60%。
• 分布式限流与熔断： 使用 Redis 的 INCR + 过期时间实现滑动窗口限流；结合 SETNX 实现熔断开关，保护下游索引服务。
• 索引构建状态协调： 记录全量索引版本号、增量消费位点、索引 Swap 状态，确保多副本索引构建的一致性。
• 错误码映射与断言缓存： 在契约测试框架中，Redis 存储 错误码 → 业务提示 的映射表，测试用例通过断言 Redis 中的错误码值来验证服务行为。

2.4 契约测试视角下的通信链路

在契约测试中，搜索服务的通信链路被抽象为以下三个可断言接口：

1. 客户端 → 搜索查询服务（RPC）： 断言请求格式、超时行为、错误码映射。
2. 搜索查询服务 → Redis（缓存协议）： 断言 Redis 错误码（如 MOVED、ASK、BUSY）是否被正确转换为业务错误码。
3. 搜索查询服务 → 索引存储（内部 RPC）： 断言索引不可用时的降级策略与错误码。

// 契约测试示例：Redis 错误码断言
// 当 Redis 返回 MOVED 重定向时，搜索服务应返回 3001（缓存路由异常）
@Test
public void testRedisMovedErrorMapping() {
    // 模拟 Redis 返回 MOVED 错误
    redisMock.willReturn(new RedisException("MOVED 12345 192.168.1.1:6379"));
    
    SearchResponse response = searchService.search("keyword");
    
    // 断言业务错误码为 3001，而非直接透传 MOVED
    assertThat(response.getCode()).isEqualTo(3001);
    assertThat(response.getMessage()).contains("缓存路由异常");
}