Java项目连接Redis的核心是引入Lettuce依赖、配置application.yml参数、使用StringRedisTemplate操作及验证连通性;需确保Redis已启动、网络通畅、配置准确。

Java 项目连接 Redis,核心是引入客户端依赖、配置连接参数、创建连接对象并验证连通性。重点不在“装 Redis”,而在 Java 应用如何稳定、高效地与它通信。
添加 Redis 客户端依赖(推荐 Lettuce)
Lettuce 是 Spring Boot 2.0+ 默认的 Redis 客户端,线程安全、支持异步和响应式,比老的 Jedis 更适合现代应用。
在 red">pom.xml 中加入:
org.springframework.boot spring-boot-starter-data-redis
配置 Redis 连接信息(application.yml)
把地址、端口、密码、超时等写进配置文件,避免硬编码。本地单机 Redis 默认是 localhost:6379,无密码。
立即学习“Java免费学习笔记(深入)”;
示例配置:
spring:
redis:
host: localhost
port: 6379
password: # 若有密码请填写
timeout: 2000 # 连接超时,单位毫秒
lettuce:
pool:
max-active: 8
max-idle: 8
min-idle: 0
max-wait: -1ms注意:max-wait: -1ms 表示无限等待空闲连接(生产环境建议设合理值,如 1000ms)。
使用 RedisTemplate 进行基本操作
Spring Boot 自动配置好 RedisTemplate 和 StringRedisTemplate。前者泛型灵活(可存对象),后者专用于字符串,更轻量常用。
直接注入使用即可:
@Autowired private StringRedisTemplate stringRedisTemplate;// 存字符串 stringRedisTemplate.opsForValue().set("user:1001", "zhangsan");
// 取字符串 String name = stringRedisTemplate.opsForValue().get("user:1001");
// 设过期时间(10秒) stringRedisTemplate.opsForValue().set("token:abc", "xxx", Duration.ofSeconds(10));
验证连接是否成功(简单测试)
启动应用后,可在任意 Service 或 @PostConstruct 方法中试连:
- 调用 stringRedisTemplate.getConnectionFactory().getConnection(),不抛异常即说明能连上
- 执行一个简单命令,如 stringRedisTemplate.hasKey("test")
- 观察控制台是否有 Connection refused 或 Cannot connect to redis 类错误
如果报错,优先检查:Redis 是否已运行(redis-cli ping 返回 PONG)、防火墙/网络是否通、配置 host/port 是否写错、密码是否遗漏。
基本上就这些。不复杂但容易忽略细节——比如忘了启动 Redis,或配置里写了 password 却没在 Redis 配置中启用 requirepass。










