连接Neo4j因果集群报错，Spring Data Neo4j 5.0.5配置排查求助

结合你使用的SDN 5.0.5版本，我整理了几个最容易被忽略的配置点，你可以逐一排查：

1. 确认URI协议与格式是否正确 #

因果集群必须使用**bolt+routing://**协议头，而不是普通的bolt://——这个协议会启用Neo4j的路由功能，让客户端自动发现集群中的核心节点和只读副本。另外，URI里至少要包含2个以上的核心节点地址（用逗号分隔），避免单点依赖：

# 正确示例
spring.data.neo4j.uri=bolt+routing://core-node-1:7687,core-node-2:7687,core-node-3:7687

如果只写了单个节点，或者用了bolt://，客户端无法感知集群拓扑，大概率会报错。

2. 验证依赖版本兼容性 #

SDN 5.0.5需要搭配Neo4j Java Driver 1.6.x版本（比如1.6.3），版本不匹配会直接导致集群功能失效（比如无法识别bolt+routing协议）。如果用Maven，你可以检查pom.xml里的依赖：

<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-neo4j</artifactId>
    <version>5.0.5.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.neo4j.driver</groupId>
    <artifactId>neo4j-java-driver</artifactId>
    <version>1.6.3</version>
</dependency>

如果是Spring Boot项目，要确保spring-boot-starter-data-neo4j的版本和SDN 5.0.5匹配（对应Spring Boot 2.0.x版本）。

3. 检查认证与权限配置 #

如果你的Neo4j集群开启了认证（默认是开启的），必须配置正确的用户名和密码，而且这个用户需要具备访问集群的权限（至少要有READ和WRITE权限，管理员用户neo4j默认拥有所有权限）：

spring.data.neo4j.username=neo4j
spring.data.neo4j.password=your-cluster-password

如果用户名密码错误，会直接抛出认证失败的异常。

4. 网络与集群可用性检查 #

• 确保应用服务器能ping通所有Neo4j核心节点，7687端口（bolt默认端口）没有被防火墙拦截；
• 确认Neo4j集群本身是健康的：登录任意核心节点，执行CALL dbms.cluster.overview()，查看所有节点状态是否为ONLINE。

5. 连接池配置（可选但重要） #

集群模式下，连接池的配置会影响稳定性，你可以通过驱动配置来调整（SDN 5.0.5可以通过org.neo4j.driver.v1.Config来配置）：

@Bean
public Driver neo4jDriver() {
    Config config = Config.builder()
            .withMaxConnectionPoolSize(10) // 根据业务场景调整连接数
            .build();
    return GraphDatabase.driver("bolt+routing://core-node-1:7687,core-node-2:7687", AuthTokens.basic("neo4j", "your-password"), config);
}

如果连接池太小，高并发场景下会出现连接耗尽的错误。

如果以上配置都没问题，建议把具体的错误日志贴出来——比如是连接超时、认证失败还是路由发现失败，这样能更精准定位问题。

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