Spring Boot升级后Neo4j OGM Session接口实例化失败问题

1. 确认Neo4j OGM与Spring Boot 3.x的兼容性 #

Spring Boot 3.x基于Spring 6，要求依赖适配Jakarta EE API（替代旧Java EE），旧版本Neo4j OGM可能未支持该规范：

• 需使用Neo4j OGM 4.0.0+版本，该系列已适配Jakarta EE和Spring 6。
• 调整build.gradle中的依赖声明，示例：

implementation 'org.neo4j:neo4j-ogm-core:4.0.8'
implementation 'org.neo4j:neo4j-ogm-spring-boot-starter:4.0.8'

2. 检查Spring Boot自动配置有效性 #

Spring Boot 3.x移除了部分旧自动配置类，Neo4j OGM的自动装配可能需显式触发：

• 在启动类上添加@EnableNeo4jRepositories（扫描OGM仓库）和@EntityScan（扫描OGM实体类）。
• 若自动配置失效，手动配置SessionFactory与Session Bean：

@Configuration
@EnableNeo4jRepositories(basePackages = "com.yourpackage.repositories")
@EntityScan(basePackages = "com.yourpackage.entities")
public class Neo4jOgmConfig {

    @Value("${spring.data.neo4j.uri}")
    private String neo4jUri;

    @Value("${spring.data.neo4j.username}")
    private String username;

    @Value("${spring.data.neo4j.password}")
    private String password;

    @Bean
    public SessionFactory sessionFactory() {
        return new SessionFactory(configuration(), "com.yourpackage.entities");
    }

    @Bean
    public org.neo4j.ogm.config.Configuration configuration() {
        return new org.neo4j.ogm.config.Configuration.Builder()
                .uri(neo4jUri)
                .credentials(username, password)
                .build();
    }

    @Bean
    public Session session(SessionFactory sessionFactory) {
        return sessionFactory.openSession();
    }
}

3. 解决Java 17模块系统限制 #

Java 17的强封装特性可能阻断Neo4j OGM对内部类的访问：

• 在build.gradle中添加JVM启动参数，解除模块封装限制：

tasks.withType(JavaExec) {
    jvmArgs = [
        "--add-opens=java.base/java.lang=ALL-UNNAMED",
        "--add-opens=java.base/java.util=ALL-UNNAMED"
    ]
}

• 若项目使用模块化（存在module-info.java），需声明对Neo4j OGM模块的依赖：

module com.yourpackage.phylodb {
    requires org.neo4j.ogm.core;
    requires org.neo4j.ogm.spring.boot.starter;
    // 按需添加其他依赖模块
}

4. 排查依赖冲突 #

Gradle中可能残留旧版本Neo4j相关依赖，引发兼容性问题：

• 执行命令./gradlew dependencyInsight --dependency org.neo4j.ogm，查看所有OGM相关依赖版本，确保无3.x及以下版本被引入。
• 若发现冲突，在依赖声明中排除旧版本：

implementation 'some-third-party-dependency' {
    exclude group: 'org.neo4j', module: 'neo4j-ogm-core'
}

5. 验证Neo4j驱动版本适配 #

Neo4j OGM依赖Neo4j驱动，需确保两者版本兼容：

• 参考Neo4j OGM官方文档，OGM 4.x对应Neo4j驱动4.4+版本。
• 在build.gradle中指定兼容的驱动版本：

implementation 'org.neo4j.driver:neo4j-java-driver:4.4.18'

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