📚 课程目录第3章 Redis基础

3. Redis基础：Redis数据结构简介、Spring Boot中RedisTemplate与StringRedisTemplate

在构建缓存层回归冒烟测试方案之前，必须扎实掌握Redis的数据结构体系以及Spring Boot中与之交互的核心API。本章将围绕Redis的五种基本数据类型展开，并深入解析RedisTemplate与StringRedisTemplate的差异与适用场景，为后续的缓存操作与测试脚本编写奠定基础。

3.1 Redis核心数据结构概览

Redis并非简单的键值存储，其值支持多种数据结构。理解这些结构的特性、底层实现与适用场景，是设计高效缓存策略的前提。

数据结构	内部编码（示例）	最大元素数	典型应用场景	冒烟测试关注点
String（字符串）	int / embstr / raw	512 MB（单值）	缓存对象JSON、计数器、分布式锁	序列化/反序列化一致性、TTL过期
Hash（哈希）	ziplist / hashtable	2^32 - 1（字段数）	对象部分字段缓存、购物车	字段级CRUD、批量操作原子性
List（列表）	quicklist	2^32 - 1	消息队列、最新消息列表	LPUSH/RPOP阻塞与非阻塞行为
Set（集合）	intset / hashtable	2^32 - 1	标签系统、去重统计	交集/并集/差集运算正确性
Sorted Set（有序集合）	ziplist / skiplist	2^32 - 1	排行榜、延时队列	分数更新与排名一致性

测试视角提示： 在冒烟测试中，不必覆盖所有内部编码转换边界，但必须验证每种数据结构在RedisTemplate下的基本操作是否返回预期类型，以及序列化配置是否导致数据损坏。

3.2 数据结构选择决策流程

以下SVG图展示了在缓存设计阶段，根据业务需求选择合适Redis数据结构的决策路径。该流程直接指导测试用例的编写方向。

    测试设计要点： 上述决策树中的每个分支都对应一组冒烟测试用例。例如，当业务需要“去重统计”时，测试应覆盖Set的SADD、SMEMBERS、SINTER操作，并验证重复元素不会被二次添加。

3.3 Spring Boot中的RedisTemplate与StringRedisTemplate

Spring Data Redis提供了两种核心模板类来操作Redis。它们的本质区别在于序列化机制，这直接影响缓存数据的可读性与跨平台兼容性。

3.3.1 核心差异对比

对比维度	RedisTemplate	StringRedisTemplate
默认序列化器	JdkSerializationRedisAdapter（二进制）	StringRedisSerializer（UTF-8）
Key序列化	JdkSerializationRedisSerializer	StringRedisSerializer
Value序列化	JdkSerializationRedisSerializer	StringRedisSerializer
存储结果	二进制乱码（如 \xAC\xED\x00\x05t...）	纯文本，可直接用redis-cli查看
适用场景	对象缓存、内部系统交互	字符串缓存、与前端/非Java系统交互
跨语言兼容性	差（仅Java可反序列化）	好（JSON/普通字符串）
冒烟测试风险	序列化失败、类型转换异常	字符编码不一致、特殊字符转义

常见陷阱： 使用RedisTemplate存储一个POJO对象后，若直接通过redis-cli的GET命令查看，会看到不可读的二进制数据。这并非错误，而是序列化策略所致。在冒烟测试中，必须确保读取端使用相同的序列化配置，否则会抛出SerializationException。

3.3.2 序列化机制内部架构

下图展示了RedisTemplate与StringRedisTemplate在序列化层的关键差异，以及它们与Redis Server的交互路径。

3.4 代码实战：配置与基础操作

以下代码展示了如何在Spring Boot中配置并使用两种模板。注意观察序列化器的显式声明方式，这是冒烟测试中排查数据异常的关键切入点。

3.4.1 配置类示例

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);

        // 使用Jackson2JsonRedisSerializer替换默认的Jdk序列化
        Jackson2JsonRedisSerializer<Object> jacksonSerializer =
                new Jackson2JsonRedisSerializer<>(Object.class);
        ObjectMapper om = new ObjectMapper();
        om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
        om.activateDefaultTyping(LazyValidatorFactory.INSTANCE,
                ObjectMapper.DefaultTyping.NON_FINAL);
        jacksonSerializer.setObjectMapper(om);

        // 设置Key和Value的序列化
        template.setKeySerializer(new StringRedisSerializer());
        template.setValueSerializer(jacksonSerializer);
        template.setHashKeySerializer(new StringRedisSerializer());
        template.setHashValueSerializer(jacksonSerializer);
        template.afterPropertiesSet();
        return template;
    }

    @Bean
    public StringRedisTemplate stringRedisTemplate(RedisConnectionFactory factory) {
        // StringRedisTemplate默认已配置StringRedisSerializer
        return new StringRedisTemplate(factory);
    }
}

3.4.2 基础操作测试片段

@SpringBootTest
public class RedisTemplateBasicOpsTest {

    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    @Autowired
    private StringRedisTemplate stringRedisTemplate;

    @Test
    public void testStringOperations() {
        // StringRedisTemplate 操作
        stringRedisTemplate.opsForValue().set("test:str", "Hello Redis");
        String value = stringRedisTemplate.opsForValue().get("test:str");
        assert "Hello Redis".equals(value);

        // RedisTemplate 操作（需确保Value可序列化）
        redisTemplate.opsForValue().set("test:obj", new User("Alice", 30));
        User cachedUser = (User) redisTemplate.opsForValue().get("test:obj");
        assert "Alice".equals(cachedUser.getName());
    }

    @Test
    public void testHashOperations() {
        // 操作Hash结构
        redisTemplate.opsForHash().put("test:hash", "field1", "value1");
        redisTemplate.opsForHash().put("test:hash", "field2", "value2");
        Map<Object, Object> entries = redisTemplate.opsForHash().entries("test:hash");
        assert entries.size() == 2;
    }
}

冒烟测试最佳实践： 在测试套件中，应至少包含一个“序列化兼容性测试用例”——使用StringRedisTemplate写入数据，再用RedisTemplate（配置了String序列化器）读取，反之亦然。这能提前暴露序列化配置不一致导致的ClassCastException或数据丢失问题。

3.5 本章小结

数据结构选择：根据业务对排序、字段、去重、队列的需求，从Sorted Set、Hash、Set、List、String中选取最合适的类型。
模板差异：RedisTemplate默认使用JDK二进制序列化，适合内部对象缓存；StringRedisTemplate使用UTF-8文本序列化，适合跨平台与可读性要求高的场景。
序列化配置：在冒烟测试中，必须显式验证序列化器配置，避免因默认行为导致的二进制乱码或反序列化失败。
测试覆盖：每种数据结构的基本CRUD操作、TTL过期行为、以及两种模板之间的数据互读，都应纳入回归冒烟测试用例集。