GDS 2.4.4无法在Neo4j 5.11.0分析集群中加载的排查求助

环境信息 #

• OS: Amazon Linux 2
• Java:
  • openjdk 17.0.8 2023-07-18 LTS
  • OpenJDK Runtime Environment Corretto-17.0.8.7.1 (build 17.0.8+7-LTS)
  • OpenJDK 64-Bit Server VM Corretto-17.0.8.7.1 (build 17.0.8+7-LTS, mixed mode, sharing)
• Neo4j版本: 5.11.0
• GDS版本: 2.4.4
• Neo4j采用RPM安装及默认文件结构

错误现象 #

debug.log中出现大量如下错误：

Failed to load .... from plugin jar `/var/lib/neo4j/plugins/neo4j-graph-data-science-2.4.4.jar`: java.lang.NoClassDefFoundError: .... 

（日志过长未完整展示）

GDS企业版安装在secondary服务器上，已尝试使用graphdatascience的neo4j-graph-data-science-2.4.4.zip及GitHub的neo4j-graph-data-science-2.4.4.jar进行安装，安装细节如下：

• 路径：默认NEO4J_HOME下的/var/lib/neo4j/plugins
• 文件名：解压默认名称neo4j-graph-data-science-2.4.4.jar
• 所有者及组：neo4j
• 权限：0775

服务器配置 #

Secondary服务器配置 #

server.directories.plugins=/var/lib/neo4j/plugins
initial.dbms.default_primaries_count=1
initial.dbms.default_secondaries_count=1
server.default_listen_address=0.0.0.0
server.default_advertised_address= SERVER IP
dbms.cluster.discovery.endpoints= LIST OF ALL SERVERS IPS
server.bolt.enabled=true
server.http.enabled=true
initial.server.mode_constraint=SECONDARY
server.cluster.system_database_mode=SECONDARY
dbms.security.procedures.unrestricted=apoc.*,gds.*
dbms.security.procedures.allowlist=apoc.coll.*,apoc.load.*,apoc.*,gds.*
gds.enterprise.license_file=/var/lib/neo4j/licenses/gds_activation_key
dbms.routing.enabled=true
dbms.routing.default_router=SERVER

Primary/Writer服务器配置 #

server.directories.plugins=/var/lib/neo4j/plugins
initial.dbms.default_primaries_count=1
initial.dbms.default_secondaries_count=1
server.default_listen_address=0.0.0.0
server.default_advertised_address= SERVER IP
dbms.cluster.discovery.endpoints= SERVER IP
server.bolt.enabled=true
server.http.enabled=true
dbms.security.procedures.unrestricted=apoc.*
dbms.security.procedures.allowlist=apoc.coll.*,apoc.load.*,apoc.*
dbms.routing.enabled=true
dbms.routing.default_router=SERVER

其他情况 #

• 集群可正常启动，可通过默认地址http://IP:7474访问UI
• 执行RETURN gds.version();时出现语法错误：

Neo.ClientError.Statement.SyntaxError Unknown function 'gds.version' (line 1, column 8 (offset: 7)) "RETURN gds.version() AS gds.version()"

• 可通过SHOW SERVERS YIELD *;确认集群配置正常
• 可通过RETURN apoc.version();确认APOC安装正常

问题原因及解决办法 #

原因 #

1. 集群插件不一致：仅在Secondary节点安装GDS，Primary节点未部署，导致集群内插件环境不统一，类加载依赖缺失，触发NoClassDefFoundError。
2. 安装包版本不符：GitHub上的neo4j-graph-data-science-2.4.4.jar大概率是社区版，缺少企业版专属的依赖类文件，导致加载失败。
3. 权限配置问题：虽然JAR包权限设置为0775，但需确认GDS许可证文件gds_activation_key的权限是否允许neo4j进程读取，权限不足会阻碍GDS初始化。

解决办法 #

1. 全集群同步安装GDS：在Primary和所有Secondary节点的/var/lib/neo4j/plugins目录下，放置同一版本的GDS企业版JAR包，保证集群所有节点插件环境一致。
2. 使用官方企业版安装包：从官方渠道获取对应版本的GDS企业版压缩包，解压后将JAR包放入plugins目录，避免使用GitHub的社区版包。
3. 修正权限设置：
   • 将GDS JAR包权限调整为0644或0755（无需0775，避免过度开放权限），所有者和组保持为neo4j
   • 确保gds_activation_key文件所有者为neo4j，权限设置为0644，保证neo4j进程可读取
4. 重启所有节点：完成配置后，依次重启Primary和Secondary节点，使配置生效。
5. 验证安装结果：节点重启后执行RETURN gds.version();，确认GDS正常加载；若仍报错，查看debug.log完整错误信息，定位缺失类对应的依赖问题。

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