Spring Boot 3.0.0中捕获Redis连接异常并精简日志输出

可以通过以下两种方式实现只输出简洁日志、不打印完整堆栈：

1. 调整日志框架配置（推荐） #

直接在日志配置文件中针对Redis连接异常类，禁用堆栈跟踪输出。以Logback为例，在logback-spring.xml中添加如下配置：

<configuration>
    <!-- 保留原有日志配置 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
            <evaluator>
                <expression>throwable != null &amp;&amp; throwable instanceof org.springframework.data.redis.connection.RedisConnectionFailureException</expression>
            </evaluator>
            <!-- 匹配到Redis连接异常时，只输出消息不打印堆栈 -->
            <onMatch>NEUTRAL</onMatch>
            <onMismatch>ACCEPT</onMismatch>
        </filter>
    </appender>

    <!-- 针对Redis客户端日志做精简配置 -->
    <logger name="io.lettuce.core" level="WARN" additivity="false">
        <appender-ref ref="CONSOLE"/>
    </logger>
    <logger name="org.springframework.data.redis.connection" level="WARN" additivity="false">
        <appender-ref ref="CONSOLE"/>
    </logger>
</configuration>

配置后，触发RedisConnectionFailureException时只会输出简洁的错误消息，不会打印完整堆栈。

2. 自定义Redis连接工厂初始化逻辑 #

通过自定义RedisConnectionFactory Bean，在初始化阶段捕获连接异常并输出精简日志：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFailureException;
import org.springframework.data.redis.connection.lettuce.LettuceConnectionFactory;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@Configuration
public class RedisConfig {
    private static final Logger logger = LoggerFactory.getLogger(RedisConfig.class);

    @Bean
    public LettuceConnectionFactory lettuceConnectionFactory() {
        LettuceConnectionFactory factory = new LettuceConnectionFactory();
        try {
            factory.afterPropertiesSet();
        } catch (RedisConnectionFailureException e) {
            // 输出精简日志，跳过堆栈打印
            logger.warn("Redis连接失败: 服务器未启动或地址配置错误");
            // 无需抛出异常，应用可正常启动
        }
        return factory;
    }
}

如果项目使用Jedis作为Redis客户端，只需将LettuceConnectionFactory替换为JedisConnectionFactory，逻辑保持一致。

内容的提问来源于stack exchange，提问作者tweetysat