知识库

由于未管理的扩展或插件配置错误导致的启动失败

有时，在升级后，可能会遇到 Neo4j 服务器初始化失败，异常类似于

2019-11-14 12:57:40.446+0000 ERROR Failed to start Neo4j:
Starting Neo4j failed: Component 'org.neo4j.server.AbstractNeoServer$ServerComponentsLifecycleAdapter@7f7eeaaf' was successfully
initialized, but failed to start. Please see the attached cause exception "The ResourceConfig instance does not contain any root
resource classes.". Starting Neo4j failed: Component 'org.neo4j.server.AbstractNeoServer$ServerComponentsLifecycleAdapter@7f7eeaaf'
was successfully initialized, but failed to start. Please see the attached cause exception "The ResourceConfig instance does not
contain any root resource classes.".

此异常通常在以下情况下抛出

当插件目录（默认设置为 $NEO4J_HOME/plugins）中包含无效的插件 JAR 时。当该 JAR 不再对应新升级的 Neo4j 版本时。当 dbms.unmanaged_extension_classes 所定义的路径无效或不可达时。当位于该路径的非托管扩展未包含异常中指出的必需资源类时。

如果使用插件（Neo4j 官方或自定义），例如使用 apoc，请确保仅存在一个与当前安装的 Neo4j 版本兼容的插件版本。

另外，假设当前并不需要使用任何已配置的非托管扩展。为使服务器初始化（被上述异常阻止）能够继续，最简单的解决办法是将 neo4j.conf 中的此设置注释掉，写成 #dbms.unmanaged_extension_classes。如果确实需要该扩展，则必须检查配置路径及其权限，并最终确认扩展工作所需的类是否存在。

© . This site is unofficial and not affiliated with Neo4j, Inc.