使用Spring Boot @DataNeo4jTest测试Neo4j自定义Cypher查询遇问题

我之前在做Spring Boot + Neo4j的测试时，刚好碰到过和你一模一样的问题！结合Spring Data Neo4j（SDN）官方文档第10.3.1节的内容，以及我实际调试的经验，给你整理下具体的解决方案：

问题1：测试尝试通过BOLT驱动连接Neo4j实例 #

默认情况下，@DataNeo4jTest应该自动配置嵌入式Neo4j实例用于测试，但如果你的项目依赖中包含了Neo4j BOLT驱动，Spring Boot的自动配置逻辑可能会“跑偏”，优先尝试连接外部Neo4j实例而非使用嵌入式的。解决步骤如下：

• 检查Maven依赖，把BOLT驱动的scope设置为runtime，让它只在生产环境生效，测试环境不加载：

  <dependency>
      <groupId>org.neo4j.driver</groupId>
      <artifactId>neo4j-java-driver</artifactId>
      <scope>runtime</scope>
  </dependency>
  

• 如果必须在测试中保留BOLT驱动依赖，可以在测试类上添加@AutoConfigureTestDatabase注解，强制使用嵌入式测试数据库：

  @DataNeo4jTest
  @AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.ANY)
  public class YourRepositoryTest {
      // 你的测试代码
  }
  

  这个注解会覆盖默认的配置逻辑，确保测试用的是嵌入式Neo4j。

问题2：测试无法加载嵌入式驱动 #

这个问题大多是依赖缺失或者版本不兼容导致的。根据SDN文档10.3.1节的说明，@DataNeo4jTest需要Neo4j嵌入式驱动的支持，你可以按以下方式排查：

• 确保Maven中引入了Neo4j嵌入式驱动的测试依赖，版本要和你使用的SDN版本兼容（比如SDN 6.x对应Neo4j 4.x/5.x，SDN 7.x对应Neo4j 5.x+）：

  <dependency>
      <groupId>org.neo4j</groupId>
      <artifactId>neo4j</artifactId>
      <version>你的SDN对应版本号</version>
      <scope>test</scope>
  </dependency>
  

• 检查是否有其他依赖排除了neo4j-core或neo4j-embedded这类核心包，如果有的话，取消排除，保证测试时能加载到嵌入式驱动的类。
• 如果你用的是Spring Boot Starter，确保spring-boot-starter-data-neo4j依赖正确引入，它会自动帮你管理兼容的Neo4j版本，不用手动指定：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-neo4j</artifactId>
  </dependency>
  

额外小提示 #

• 测试自定义Cypher的时候，记得你的Repository接口要正确继承Neo4jRepository，而且@Query注解里的Cypher语法要准确，不然也可能间接导致驱动加载异常。
• 如果还是搞不定，可以在测试类里加个日志注解（比如@Slf4j），查看Neo4j驱动初始化的详细日志，从异常信息里找具体的问题点，比如缺了哪个类，或者版本不匹配的提示。

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