Redis服务就绪需先用redis-cli ping验证：返回PONG表示服务运行、网络通畅、认证正确；若失败，依次检查redis-server是否启动、防火墙端口、密码配置及bind/protected-mode设置。
Java 项目本身不直接运行 redis-cli，但你在开发调试阶段，需要用 redis-cli 快速验证 Redis 服务是否就绪、网络是否通、认证是否正确——这是 Java 应用能连上 Redis 的前提。只要 redis-cli 能成功 PING 通，Java 客户端（如 Lettuce 或 Jedis）大概率也能连。
确认 Redis 服务已启动并监听正确地址
Java 项目连接 Redis 前，先确保服务端在运行：
- Linux/macOS：运行
redis-cli ping，若返回 PONG，说明本地默认实例（127.0.0.1:6379）正常； - 若 Redis 改了端口（比如 6380），执行
redis-cli -p 6380 ping； - 若 Redis 启用了密码（
requirepass配置项），加-a参数：redis-cli -a "yourpass" ping； - 若 Redis 绑定到非本地地址（如
0.0.0.0或某内网 IP），需显式指定主机：redis-cli -h 192.168.1.100 -p 6379 ping。
常见连接失败原因与对应 cli 检查方式
Java 报 “Connection refused” 或 “Authentication failed” 时，用 redis-cli 快速定位：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
服务没启：运行
redis-cli ping提示 Could not connect to Redis at 127.0.0.1:6379: Connection refused → 检查是否执行了redis-server，或服务状态：sudo systemctl status redis-server（Linux）； -
防火墙/端口拦截：远程连接失败时，先在服务端本机执行
redis-cli ping确认服务正常，再从 Java 所在机器执行telnet 192.168.1.100 6379测试端口可达性； -
密码错误或未配 auth：
redis-cli -a wrongpass ping返回 (error) ERR invalid password；而未加-a却需要密码时，会提示 (error) NOAUTH Authentication required； -
bind 限制导致拒绝远程连接：若配置中只写
bind 127.0.0.1，则redis-cli -h 其他IP必然失败，需检查/etc/redis/redis.conf中的bind和protected-mode设置。
进阶：用 redis-cli 模拟 Java 客户端行为
Java 客户端通常使用默认 DB 0、无用户名、明文密码（如有）。你可用以下命令贴近真实场景测试：
立即学习“Java免费学习笔记（深入）”；
- 带密码 + 指定 DB：
redis-cli -a "mypass" -n 0 ping（-n 0表示使用数据库索引 0，Spring Boot 默认即此）； - 连接后手动执行 Java 常用操作，快速验证逻辑：
SET hello java→GET hello→ 看是否返回 "java"； - 查看当前配置是否匹配 Java 期望：
CONFIG GET requirepass、CONFIG GET bind、INFO server查版本和运行参数。
只要 redis-cli 能稳定返回 PONG 并执行 SET/GET，Java 侧配置 host、port、password 正确，基本就不会卡在连接环节。后续重点排查 Java 客户端连接池、超时、SSL 等高级配置。
