Grails 5.0.0 RC1集成Neo4j GORM报错及配置示例咨询

错误原因分析 #

你触发的异常核心原因是当前运行的Grails3示例默认启用了嵌入式Neo4j服务，但项目classpath中缺少运行嵌入式服务必需的neo4j-harness依赖包，同时Grails3示例和你使用的Grails 5.0.0 RC1版本存在兼容性差异，需要调整适配。

适配Grails 5的Neo4j配置方案 #

方案一：使用独立部署的Neo4j服务（推荐日常开发/生产使用） #

不需要引入neo4j-harness依赖，仅需调整配置连接本地独立安装的Neo4j实例即可。

1. 调整build.gradle依赖配置

dependencies {
    // 保留与你GORM版本匹配的Neo4j插件依赖
    implementation "org.grails.plugins:neo4j:7.1.0.RC2"
    // 无需额外添加嵌入式相关依赖
}

2. 调整grails-app/conf/application.yml连接配置

grails:
  neo4j:
    type: remote
    uri: bolt://localhost:7687 # 替换为你的Neo4j服务bolt地址
    username: neo4j # 替换为你的Neo4j用户名
    password: 你的Neo4j登录密码 # 替换为你的Neo4j密码

方案二：使用嵌入式Neo4j（仅适合本地测试使用） #

1. 调整build.gradle依赖配置，补充缺失的运行包

dependencies {
    implementation "org.grails.plugins:neo4j:7.1.0.RC2"
    // 补充嵌入式Neo4j运行必需依赖，版本和GORM 7.1适配的Neo4j 4.x版本对齐即可
    runtimeOnly "org.neo4j.test:neo4j-harness:4.4.18"
}

2. 调整grails-app/conf/application.yml嵌入式配置

grails:
  neo4j:
    type: embedded
    embedded:
      dataLocation: ./neo4j-test-data # 自定义嵌入式数据存储路径

兼容适配调整（针对Grails 3示例迁移到Grails 5） #

在application.yml中添加如下配置，禁用冲突的健康检查避免启动报错：

management:
  health:
    neo4j:
      enabled: false

调整完成后执行gradlew.bat clean bootRun启动项目即可正常运行。

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