Spring Data Neo4j抛Connection reset by peer异常如何立即恢复连接

该异常本质是Neo4j Java驱动连接池中的长连接被防火墙、负载均衡等中间网络组件或Neo4j服务端主动断开，驱动未检测到连接失效，直接使用已断开的连接发起请求就会抛出Connection reset by peer错误。默认配置下驱动没有开启连接存活校验，需要多次请求失败后才会淘汰失效连接，因此会出现等待一段时间才自行恢复的情况。

以下是Spring Boot集成Spring Data Neo4j场景下的配置调整项，均在application.yml/application.properties中配置即可：

• 开启连接存活校验
  配置连接从池内取出时的存活检测阈值，空闲超过该时长的连接会先执行探测，确认存活才会用于请求，失效连接直接被清理。

  spring.neo4j.pool.connection-liveness-check-timeout: 2000
  

  单位为毫秒，建议设置为比你方网络设备的空闲连接断开超时时间小30秒以上即可。
• 限制连接最大生命周期
  强制连接池内的连接超过指定时长后自动销毁重建，避免连接空闲过久被网络侧切断。

  spring.neo4j.pool.max-connection-lifetime: 1800000
  

  示例为30分钟，可根据实际场景调整，建议小于服务端/防火墙的空闲连接断开时长。
• 开启自动重试策略
  针对网络闪断、临时不可用这类瞬态异常，驱动会自动重试，无需业务层感知。

  spring.neo4j.driver.retry.strategy: auto
  spring.neo4j.driver.retry.max-attempts: 3
  

• 调整连接获取超时时间
  限制从连接池获取连接的最大等待时长，避免长时间阻塞。

  spring.neo4j.pool.connection-acquisition-timeout: 5000
  

  单位为毫秒，示例为5秒。

如果你没有使用Spring Boot的自动配置，自行声明Neo4j Driver Bean时可参考如下配置：

import org.neo4j.driver.AuthTokens;
import org.neo4j.driver.Config;
import org.neo4j.driver.GraphDatabase;
import org.neo4j.driver.Driver;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.time.Duration;

@Configuration
public class Neo4jCustomConfig {

    @Bean
    public Driver neo4jDriver() {
        Config driverConfig = Config.builder()
                // 连接池配置
                .withConnectionPoolSettings(Config.ConnectionPoolSettings.builder()
                        .withConnectionLivenessCheckTimeout(Duration.ofSeconds(2))
                        .withMaxConnectionLifetime(Duration.ofMinutes(30))
                        .withConnectionAcquisitionTimeout(Duration.ofSeconds(5))
                        .build())
                // 重试策略配置
                .withRetrySettings(Config.RetrySettings.builder()
                        .withMaxAttempts(3)
                        .build())
                .build();
        return GraphDatabase.driver("bolt://你的Neo4j地址:7687", 
                AuthTokens.basic("用户名", "密码"), driverConfig);
    }
}

以上配置调整完成后，失效连接会被快速检测清理，新请求会自动创建新连接，无需等待即可恢复，偶发的网络闪断也会被自动重试，不会抛出异常到业务层。

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