为什么Spring Boot 2.x升级到3.x后Redis报错_检查jakarta包路径替换问题-Redis-PHP中文网

redis启动失败但无classnotfoundexception时，首要排查spring.data.redis配置路径，因spring boot 3.x已弃用spring.redis.xxx旧配置项，必须统一改为spring.data.redis.xxx（含host、port、password、lettuce.pool.*等），否则redisconnectionfactory因缺失连接参数而静默失效。

为什么spring boot 2.x升级到3.x后redis报错_检查jakarta包路径替换问题

Redis启动失败但没报ClassNotFoundException？先盯住spring.data.redis配置路径

Spring Boot 3.x 不再识别 spring.redis.host 这类旧配置项，直接降级为 warning 并静默忽略——结果就是 RedisConnectionFactory 拿不到 host/port，最终在运行时抛出连接超时或空指针，而不是你预期的配置错误提示。

必须把所有 spring.redis.xxx 改成 spring.data.redis.xxx，包括：host、port、password、database、timeout、lettuce.pool.* 等。application.yml 示例：

spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      password: 
      database: 0
      timeout: 2000
      lettuce:
        pool:
          max-active: 8

不要只改一部分，漏掉 lettuce.pool.max-active 这类嵌套项也会导致连接池未生效
如果用了 Jedis，需额外排除 Lettuce 并显式引入 redis.clients:jedis，否则 Spring Boot 3.x 默认只加载 Lettuce
spring.redis.ssl=true 这种写法在 3.x 中完全无效，必须写成 spring.data.redis.ssl=true

javax.servlet.HttpServletRequest 注入失败导致 Redis 验证码逻辑崩溃

典型报错是：java.lang.IllegalStateException: No primary or single unique constructor found for interface javax.servlet.http.HttpServletRequest。这不是 Redis 自身的问题，而是你的验证码或登录接口里，用 @RequestParam 或 @RequestBody 尝试自动注入了 HttpServletRequest，而 Spring Boot 3.x 的 DispatcherServlet 已切换为 Jakarta 版本，容器里根本不存在 javax.servlet 类型的 Bean。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

所有 Controller 方法参数中的 javax.servlet.http.HttpServletRequest 必须替换成 jakarta.servlet.http.HttpServletRequest
同理检查 HttpServletResponse、ServletContext、ServletInputStream、ReadListener 等类型
如果用了 Filter 或自定义 OncePerRequestFilter，其 doFilter 方法签名也得同步改参类型
IDE 全局替换时注意别误伤注释或字符串里的 javax 文本

commons-fileupload 与 Jakarta Servlet 冲突引发 Redis 文件上传失败

如果你的项目用 Redis 存验证码图片、同时又支持文件上传（比如 Excel 导入），升级后常见现象是：上传请求进不来，直接 400 或 500，日志里出现 Cannot cast jakarta.servlet.http.HttpServletRequest to javax.servlet.http.HttpServletRequest。

根本原因是 commons-fileupload:1.6.0 只认 javax.servlet 接口，而 Spring Boot 3.x 提供的是 jakarta.servlet 实例。

删掉旧依赖 commons-fileupload:commons-fileupload:1.6.0
换成 Jakarta 兼容版：org.apache.commons:commons-fileupload2-jakarta-servlet5:2.0.0-M2
DiskFileItemFactory 构造方式变了，不能 new，得用 DiskFileItemFactory.builder().get()
ServletFileUpload 类已废弃，改用 JakartaServletFileUpload
如果上传逻辑里还调用了 request.getPart()，确保该方法来自 jakarta.servlet.http.HttpServletRequest，而非遗留 wrapper 类

RedisTemplate 注入失败却提示 Hibernate 或 Validation 错误？别被误导

有时候 RedisTemplate 报 No qualifying bean，但控制台第一行异常却是 Caused by: java.lang.NoClassDefFoundError: javax/validation/ConstraintViolationException ——这说明 classpath 里混着 javax 和 jakarta 的 validation 包，ClassLoader 加载冲突，导致 Spring 容器初始化中断，后续 Redis 相关 Bean 根本没机会注册。

执行 mvn dependency:tree -Dincludes=javax.validation 和 mvn dependency:tree -Dincludes=jakarta.validation，确认两者没共存
检查是否手动引入了 hibernate-validator 旧版（5.x），应统一用 org.hibernate.validator:hibernate-validator:8.0.1.Final（Jakarta 兼容）
若用了 Lombok，确认 @Data 或 @Builder 生成的构造方法没意外触发 javax.validation 的早期校验（比如字段上有 @NotBlank 却没引入对应 API）
这种“伪 Redis 错误”往往发生在多模块项目中，父 POM 声明了 javax 依赖，子模块 upgrade 后未 clean 掉 inherited 依赖