Spring Data Neo4j 5启动报错：找不到sessionFactory Bean

嘿，我来帮你搞定这个启动异常！你遇到的NoSuchBeanDefinitionException: No bean named 'sessionFactory' available是Spring Data Neo4j（SDN）5.x版本里很常见的配置坑，主要是因为SDN 5开始彻底换了一套配置逻辑，和旧版本差异很大。

问题根源 #

SDN 5.x依赖Neo4j OGM 3.x，不再使用传统的sessionFactory定义方式，如果你还是照着旧文档或者错误的配置来，Spring容器自然找不到这个bean，进而导致sharedSessionCreatorBean依赖注入失败。

具体解决方案 #

这里给你几个针对性的排查和修复步骤：

• 确保配置类正确适配SDN 5
  你需要创建一个继承自Neo4jConfiguration的配置类，并且标注@EnableNeo4jRepositories和@EntityScan来指定你的Repository和实体类路径。这个配置类会帮你自动生成正确的sessionFactory bean，示例代码如下：

  @Configuration
  @EnableNeo4jRepositories(basePackages = "com.yourproject.repositories")
  @EntityScan(basePackages = "com.yourproject.entities")
  public class Neo4jConfig extends Neo4jConfiguration {
  
      @Value("${spring.data.neo4j.uri}")
      private String neo4jUri;
      @Value("${spring.data.neo4j.username}")
      private String username;
      @Value("${spring.data.neo4j.password}")
      private String password;
  
      @Override
      public SessionFactory sessionFactory() {
          // 这里的包路径要和你的实体类所在包一致
          return new SessionFactory(configuration(), "com.yourproject.entities");
      }
  
      @Bean
      public org.neo4j.ogm.config.Configuration configuration() {
          return new org.neo4j.ogm.config.Configuration.Builder()
                  .uri(neo4jUri)
                  .credentials(username, password)
                  .build();
      }
  }
  

  注意：不要手动给sessionFactory指定自定义bean名称，保持默认的sessionFactory，因为sharedSessionCreatorBean是默认依赖这个名称的bean。

• 检查依赖版本兼容性
  你用的SDN 5.0.7.RELEASE和Spring 5.0.6.RELEASE版本是匹配的，但要确保没有引入冲突的依赖。比如在Maven里，要避免同时引入SDN 4.x或者旧版本的Neo4j OGM，建议你的依赖只保留必要的SDN和Spring核心依赖：

  <dependencies>
      <dependency>
          <groupId>org.springframework.data</groupId>
          <artifactId>spring-data-neo4j</artifactId>
          <version>5.0.7.RELEASE</version>
      </dependency>
      <dependency>
          <groupId>org.springframework</groupId>
          <artifactId>spring-context</artifactId>
          <version>5.0.6.RELEASE</version>
      </dependency>
      <!-- 其他必要的Spring依赖，比如spring-boot-starter等 -->
  </dependencies>
  

• 移除旧的XML配置（如果有的话）
  如果你之前用的是SDN 4.x的XML配置，里面可能有手动定义sessionFactory的代码，这些在SDN 5里已经完全不适用了，建议直接换成上面的Java配置方式，避免配置冲突。

如果以上步骤都试过还是不行，你可以检查一下sharedSessionCreatorBean的定义，看看它是不是硬编码依赖了sessionFactory这个bean名称，而你的配置里生成的bean名称被改成了自定义的（比如@Bean(name="mySessionFactory")），这种情况下要么把bean名称改回sessionFactory，要么调整sharedSessionCreatorBean的依赖指向正确的bean名称。

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