Spring Data Redis 3.2.2版本升级后缓存键解析异常问题分析

问题背景

在Spring Boot 3.2.2版本升级过程中，开发者反馈在使用Redis缓存时遇到了Null key returned for cache operation异常。该问题出现在使用SpEL表达式#username作为缓存键的场景下，而切换为参数索引表达式#a0后问题得到解决。

技术细节解析

1. 缓存键解析机制变化

Spring Data Redis在3.2.x版本中对缓存键的解析逻辑进行了优化。主要变化包括：

• 参数名称解析策略调整：新版本对方法参数名的获取方式更加严格
• SpEL表达式执行上下文改进：增强了类型安全和空值处理
• 缓存键非空校验强化：明确禁止null值作为缓存键

2. 问题根本原因

当使用#username作为键表达式时，系统需要依赖编译时保留的参数名称信息。如果项目未使用-parameters编译选项或未正确配置参数名发现机制，就会导致：

1. 参数名解析失败
2. SpEL表达式求值返回null
3. 触发缓存操作的键非空校验

而#a0这种基于参数索引的表达式不依赖参数名，直接通过方法签名位置获取值，因此不受影响。

解决方案与最佳实践

1. 临时解决方案

如问题描述所示，可以使用参数位置索引：

@Cacheable(value = "user", key = "#a0", unless = "#result == null")

2. 推荐解决方案

建议采用以下方式之一：

1. 启用编译参数保留（推荐）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <parameters>true</parameters>
    </configuration>
</plugin>

2. 使用Spring的@Param注解显式声明：

@Cacheable(value = "user", key = "#username", unless = "#result == null")
public String findUsername(@Param("username") String username)

3. 结合默认键生成器：

@Cacheable(value = "user", unless = "#result == null")
// 使用SimpleKeyGenerator自动组合参数

版本兼容性建议

对于从Spring Boot 2.x升级到3.x的用户，建议特别注意：

1. 缓存配置的兼容性检查
2. 编译环境的参数配置
3. 测试用例中增加对缓存键的验证
4. 考虑逐步迁移策略而非直接升级

总结

Spring Data Redis 3.2.2版本对缓存键处理的改进体现了框架对健壮性的追求。开发者需要理解参数名解析机制的变化，并根据项目实际情况选择合适的键表达式策略。通过正确配置编译参数或采用显式声明方式，可以既保持代码可读性又确保功能正常。