SpringBoot配置Redis连接池的实现步骤

更新时间：2025年03月06日 09:37:42 作者：一个差不多的先生

本文主要介绍了SpringBoot配置Redis连接池的实现步骤,详细的讲解了连接池的作用、配置方式、连接池参数说明,具有一定的参考价值,感兴趣的可以了解一下

在 Spring Boot 项目中，合理配置 Redis 连接池是优化性能和资源利用率的关键步骤。连接池可以复用连接，减少连接创建和销毁的开销，从而显著提升应用性能。本文将详细介绍如何在 Spring Boot 中配置 Redis 连接池，并提供最佳实践建议。

一、为什么需要连接池？

Redis 是基于内存的高性能数据库，但频繁地创建和销毁连接会带来不必要的开销。连接池的作用是预先创建并维护一定数量的连接，供多个线程复用，从而减少连接的创建和销毁次数，提高应用性能。此外，连接池还可以限制最大连接数，防止因过多的并发连接导致 Redis 服务器过载。

二、连接池的配置方式

在 Spring Boot 中，可以使用 Lettuce 或 Jedis 作为 Redis 客户端。默认情况下，Spring Boot 使用 Lettuce，但也可以通过配置切换到 Jedis。以下分别介绍这两种客户端的连接池配置方法。

三、使用 Lettuce 配置连接池

Lettuce 是一个基于 Netty 的 Redis 客户端，支持连接池功能。Spring Boot 默认使用 Lettuce，因此无需额外依赖。

1. 配置文件方式

在 application.yml 或 application.properties 文件中，可以通过 spring.redis.lettuce.pool 配置连接池参数。

application.yml 示例：

spring:
  redis:
    host: 127.0.0.1
    port: 6379
    password: your_password
    timeout: 1800000  # 连接超时时间（毫秒）
    lettuce:
      pool:
        max-active: 20  # 最大活跃连接数
        max-wait: -1    # 最大阻塞等待时间（负数表示无限制）
        max-idle: 10    # 最大空闲连接数
        min-idle: 2     # 最小空闲连接数

2. Java 配置方式

如果需要更灵活的配置，可以通过 Java 配置类来定义连接池参数。

package com.example.config;

import io.lettuce.core.ClientOptions;
import io.lettuce.core.ReadFrom;
import io.lettuce.core.cluster.ClusterClientOptions;
import io.lettuce.core.cluster.ClusterTopologyRefreshOptions;
import io.lettuce.core.cluster.RedisClusterClient;
import io.lettuce.core.cluster.api.StatefulRedisClusterConnection;
import io.lettuce.core.cluster.api.sync.RedisAdvancedClusterCommands;
import io.lettuce.core.resource.ClientResources;
import io.lettuce.core.resource.DefaultClientResources;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisClusterConfiguration;
import org.springframework.data.redis.connection.lettuce.LettuceClientConfiguration;
import org.springframework.data.redis.connection.lettuce.LettuceConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.StringRedisSerializer;

import java.time.Duration;

@Configuration
public class RedisConfig {

    @Bean
    public LettuceConnectionFactory redisConnectionFactory() {
        RedisClusterConfiguration clusterConfig = new RedisClusterConfiguration()
                .clusterNode("127.0.0.1", 6379)
                .clusterNode("127.0.0.1", 6380);

        LettuceClientConfiguration clientConfig = LettuceClientConfiguration.builder()
                .clientOptions(ClientOptions.builder()
                        .disconnectedBehavior(ClientOptions.DisconnectedBehavior.REJECT_COMMANDS)
                        .build())
                .build();

        return new LettuceConnectionFactory(clusterConfig, clientConfig);
    }

    @Bean
    public RedisTemplate<String, Object> redisTemplate(LettuceConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        template.setKeySerializer(new StringRedisSerializer());
        return template;
    }
}

四、使用 Jedis 配置连接池

如果需要使用 Jedis 作为 Redis 客户端，可以通过排除默认的 Lettuce 依赖并引入 Jedis 依赖来实现。

1. 修改依赖

在 pom.xml 文件中，排除 Lettuce 并引入 Jedis 依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
    <exclusions>
        <exclusion>
            <groupId>io.lettuce</groupId>
            <artifactId>lettuce-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
</dependency>

2. 配置文件方式

在 application.yml 文件中，通过 spring.redis.jedis.pool 配置连接池参数：

spring:
  redis:
    host: 127.0.0.1
    port: 6379
    password: your_password
    timeout: 1800000
    jedis:
      pool:
        max-active: 20
        max-wait: -1
        max-idle: 10
        min-idle: 2

3. Java 配置方式

如果需要更灵活的配置，可以通过 Java 配置类来定义连接池参数：

package com.example.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisStandaloneConfiguration;
import org.springframework.data.redis.connection.jedis.JedisClientConfiguration;
import org.springframework.data.redis.connection.jedis.JedisConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.StringRedisSerializer;

import java.time.Duration;

@Configuration
public class RedisConfig {

    @Bean
    public JedisConnectionFactory redisConnectionFactory() {
        RedisStandaloneConfiguration redisConfig = new RedisStandaloneConfiguration("127.0.0.1", 6379);
        JedisClientConfiguration jedisConfig = JedisClientConfiguration.builder()
                .connectTimeout(Duration.ofMillis(1800000))
                .usePooling()
                .poolConfig(poolConfig())
                .build();

        return new JedisConnectionFactory(redisConfig, jedisConfig);
    }

    @Bean
    public RedisTemplate<String, Object> redisTemplate(JedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        template.setKeySerializer(new StringRedisSerializer());
        return template;
    }

    private JedisPoolConfig poolConfig() {
        JedisPoolConfig config = new JedisPoolConfig();
        config.setMaxTotal(20);
        config.setMaxIdle(10);
        config.setMinIdle(2);
        config.setMaxWaitMillis(-1);
        return config;
    }
}

五、连接池参数说明

以下是连接池常用参数的说明：

参数	说明
`max-active`	最大活跃连接数，限制连接池中同时存在的连接数
`max-idle`	最大空闲连接数，限制连接池中空闲连接的最大数量
`min-idle`	最小空闲连接数，连接池中保持的最小空闲连接数
`max-wait`	最大阻塞等待时间（毫秒），当连接池耗尽时，线程等待可用连接的最大时间
`timeout`	连接超时时间（毫秒），客户端等待服务器响应的超时时间

六、最佳实践建议

合理配置参数：根据应用的并发量和 Redis 服务器的性能，合理配置连接池参数。如果连接池过小，可能会导致频繁创建和销毁连接；如果连接池过大，可能会浪费资源。
监控连接池状态：定期监控连接池的使用情况，包括活跃连接数、空闲连接数等，以便及时调整参数。
使用哨兵或集群：在生产环境中，建议使用 Redis Sentinel 或 Redis Cluster 提供高可用性和水平扩展能力。
避免连接泄漏：确保在使用连接后正确释放，避免连接泄漏导致连接池耗尽。

七、总结

通过合理配置 Redis 连接池，可以显著提升 Spring Boot 应用的性能和资源利用率。无论是使用 Lettuce 还是 Jedis，Spring Boot 都提供了灵活的配置方式。希望本文能帮助你在项目中正确配置 Redis 连接池。

到此这篇关于SpringBoot配置Redis连接池的实现步骤的文章就介绍到这了,更多相关SpringBoot Redis连接池内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java实现扑克牌游戏的示例代码
想不想带上好朋友来上一局三人扑克呢？这篇文章教你如何利用Java语言实现一个简单的扑克牌游戏，文中的示例代码讲解详细，感兴趣的可以了解一下
2022-09-09
8个简单部分开启Java语言学习之路附java学习书单
8个简单部分开启Java语言学习之路，附java学习书单，这篇文章主要向大家介绍了学习java语言的方向，感兴趣的小伙伴们可以参考一下
2016-09-09
springboot+thymeleaf打包成jar后找不到静态资源的坑及解决
这篇文章主要介绍了springboot+thymeleaf打包成jar后找不到静态资源的坑及解决，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-11-11
Java中字符串拼接的一些细节分析
这篇文章主要介绍了Java中字符串拼接的一些细节分析,本文着重剖析了字符串拼接的一些性能问题、技巧等内容,需要的朋友可以参考下
2015-01-01
java 异常捕获及处理案例详解
这篇文章主要介绍了java 异常捕获及处理案例详解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
2021-09-09
Java中使用HashMap改进查找性能的步骤
这篇文章主要介绍了Java中使用HashMap改进查找性能的步骤，帮助大家更好的理解和使用Java，感兴趣的朋友可以了解下
2021-02-02
java实现五子棋小游戏
这篇文章主要介绍了java实现五子棋小游戏的相关资料，十分简单实用，推荐给大家,需要的朋友可以参考下
2015-03-03
解决MyBatis报错:There is no getter for
这篇文章主要介绍了解决MyBatis报错:There is no getter for property named'Xxx'in'class xxx.xxx.Xxx'问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-08-08
通过Java实现文件断点续传功能
用户上传大文件,网络差点的需要历时数小时，万一线路中断，不具备断点续传的服务器就只能从头重传，而断点续传就是，允许用户从上传断线的地方继续传送，这样大大减少了用户的烦恼。本文将用Java语言实现断点续传，需要的可以参考一下
2022-05-05
10个Java文件操作必备技巧分享
在我们日常的开发中，文件操作是一个非常重要的主题。文件读写、文件复制、任意位置读写、缓存等技巧都是我们必须要掌握的。本文为大家整理了10个实用的文件操作技巧，希望对大家有所帮助
2023-04-04