项目没有引入redis，执行sql查询报错Unable to connect to localhost:6379

### 解决方案分析 当遇到 `RedisConnectionFailureException` 错误时，通常表明应用程序无法成功建立与 Redis 实例的连接。此问题可能由多种原因引起，包括网络配置、Redis 服务状态以及客户端设置等。 #### 可能的原因及解决方案 1. **Redis 服务器未运行** 如果 Redis 服务未启动，则会引发此类错误。可以通过以下命令检查 Redis 是否正在运行： ```bash ps aux | grep redis-server ``` 若未发现任何进程，需手动启动 Redis 服务： ```bash sudo systemctl start redis ``` 2. **主机名或端口配置不正确** 默认情况下，Spring Data Redis 配置尝试连接至 `localhost:6379`。如果实际部署环境中的 Redis 地址不同（例如远程地址），则需要调整配置文件中的 `spring.redis.host` 和 `spring.redis.port` 属性[^1]。 修改方式如下： ```properties spring.redis.host=your_redis_host spring.redis.port=your_redis_port ``` 3. **防火墙阻止访问** 当 Redis 运行于本地以外的机器上时，可能会因防火墙规则而被拒绝访问。可以临时关闭防火墙测试连通性： ```bash sudo ufw disable ``` 或者允许特定端口通过防火墙： ```bash sudo ufw allow 6379/tcp ``` 4. **Lettuce 客户端超时设置不足** Lettuce 是 Spring Data Redis 的默认客户端实现之一。如果网络延迟较高或者 Redis 响应较慢，可能导致连接超时。增加超时时间可以帮助缓解这一问题： ```java @Bean public RedisConnectionFactory redisConnectionFactory() { RedisStandaloneConfiguration config = new RedisStandaloneConfiguration(); config.setHostName("localhost"); config.setPort(6379); LettuceClientConfiguration clientConfig = LettuceClientConfiguration.builder() .commandTimeout(Duration.ofSeconds(10)) // 设置更长的超时时间 .build(); return new LettuceConnectionFactory(config, clientConfig); } ``` 5. **单线程模式下的资源竞争** 类似于数据库连接池的概念，在高并发场景下如果没有合理管理 Redis 连接数，也可能导致连接失败。虽然 `SingleConnectionDataSource` 并非针对 Redis 设计，但它提示我们注意连接复用的重要性[^2]。建议启用连接池机制来优化性能并减少潜在冲突。 6. **依赖版本兼容性问题** 不同版本间的 API 改动有时会造成意外行为。确认当前使用的 Spring Boot 版本及其对应的 Spring Data Redis 和 Lettuce 库是否匹配至关重要。必要时升级相关组件以获得最新修复补丁[^3]。 7. **参数化查询安全性保障** 考虑到安全因素，即使是在处理缓存层的数据交互也推荐采用参数化的形式构建请求字符串，从而规避SQL注入风险类似的隐患[^4]。尽管这一步骤主要适用于关系型数据库操作，但在设计整体架构时保持一致性有助于提升系统的健壮性和可维护性。 ```java // 示例代码展示如何自定义 Redis Connection Factory 来增强灵活性 @Bean public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory){ RedisTemplate<String, Object> template = new RedisTemplate<>(); template.setKeySerializer(new StringRedisSerializer()); template.setValueSerializer(new GenericJackson2JsonRedisSerializer()); template.setConnectionFactory(factory); return template; } ```