Java项目需同时配置Redis服务端与客户端：一、安装启动Redis服务（Windows/macOS/Linux不同方式）；二、添加Lettuce或Jedis依赖，Spring Boot推荐spring-boot-starter-data-redis；三、配置连接参数并编写示例代码；四、排查连接失败常见原因。
Java项目本身不“安装”Redis，而是需要两部分配合：本地或服务器上运行Redis服务（即Redis服务端），以及Java项目中引入Redis客户端（如Jedis或Lettuce）来连接和操作它。下面分步说明如何配置可用的Redis环境。
一、安装并启动Redis服务
Redis是独立的服务程序，需单独安装和运行：
-
Windows用户：推荐使用Microsoft Archive的Redis for Windows（官方已停止维护，但稳定可用），解压后双击
redis-server.exe即可启动，默认监听127.0.0.1:6379； -
macOS用户：用Homebrew执行
brew install redis，再运行redis-server； -
Linux用户：建议用包管理器安装，如Ubuntu执行
sudo apt update && sudo apt install redis-server，安装后服务通常自动启动，可用redis-cli ping测试（返回PONG表示正常）； - 启动后可通过命令
redis-cli进入交互终端，输入ping验证连通性。
二、在Java项目中添加Redis客户端依赖
以主流构建工具为例，选择一种客户端（推荐Lettuce，Spring Boot 2.0+默认集成）：
-
Maven（pom.xml）中添加Lettuce依赖：
<dependency> <groupId>io.lettuce</groupId> <artifactId>lettuce-core</artifactId> <version>6.3.2.RELEASE</version> </dependency>
- 若使用Spring Boot，更简单：直接引入
spring-boot-starter-data-redis，它已内置Lettuce； - 避免混用Jedis和Lettuce，除非有明确兼容需求；老项目用Jedis可选
redis.clients:jedis，但注意连接池需手动管理。
三、配置Java连接Redis
确保Java能访问到Redis服务（注意网络和防火墙）：
立即学习“Java免费学习笔记（深入）”；
- 最简代码连接示例（Lettuce）：
RedisClient client = RedisClient.create("redis://127.0.0.1:6379"); StatefulRedisConnection<String, String> connection = client.connect(); RedisCommands<String, String> sync = connection.sync(); sync.set("hello", "world"); System.out.println(sync.get("hello")); // 输出 world - 生产环境建议配置连接池、超时、密码（如有）等；Spring Boot中只需在
application.yml中写：spring: redis: host: 127.0.0.1 port: 6379 password: # 如有密码则填写 timeout: 2000 - 如果Redis启用了密码，连接URL需写成
redis://:yourpass@127.0.0.1:6379或通过配置对象设置。
四、常见问题快速排查
连接失败？多数情况出在这几个点：
- Redis服务没启动 —— 执行
redis-cli ping看是否响应PONG； - IP或端口写错 —— Java代码里检查host是否为
127.0.0.1（不是localhost，尤其Docker环境）； - 防火墙/安全组拦截 —— 本地开发一般无此问题，云服务器需开放6379端口；
- Redis配置了绑定地址（
bind）或保护模式（protected-mode yes）—— 修改redis.conf，设为bind 127.0.0.1且protected-mode no（仅限测试环境）； - Spring Boot启动报错“No qualifying bean of type ‘RedisTemplate’”—— 检查是否漏加
spring-boot-starter-data-redis依赖。
基本上就这些。Redis服务和Java客户端各司其职，配通一次后，后续开发就只是写业务逻辑了。
