Solr自定义Filter插件初始化失败，核心未加载求助

• Lucene与Solr版本严重不兼容：Solr 9.7.0 内置的Lucene版本是9.7.0，你用Lucene 5.0.0编译插件，二者属于跨大版本差异，Lucene的TokenFilter、TokenFilterFactory等核心接口在5.x到9.x之间有大量API变更（比如方法签名、类结构调整），会导致类加载异常、接口实现不匹配等问题。必须使用与Solr版本完全一致的Lucene依赖编译插件。

• Jar包路径配置不匹配：你将Jar包放在${SOLR_HOME}\lib\custom目录，但solrconfig.xml中配置的是<lib dir="${solr.install.dir:../../../..}/custom_lib" regex=".*\.jar" />，存在两个问题：

  • 目录名称不匹配：custom vs custom_lib
  • 路径变量错误：${solr.install.dir}指向Solr安装目录，而你的Jar在SOLR_HOME下，应该改为${solr.home}/lib/custom或者直接使用相对路径确保指向正确目录。

• Factory类配置与实现不对应：你实现的是DebugTokenFilterFactory，但在management_schema.xml中配置的是abc.example.ReverseFilterFactory，类名完全不符，Solr无法找到对应的工厂类，必然导致初始化失败。

• 日志级别过低未捕获错误：Solr默认日志级别可能未开启Debug/Trace，导致错误信息被隐藏。需要修改Solr的日志配置文件（如log4j2.xml），将org.apache.solr和org.apache.lucene的日志级别调整为DEBUG或TRACE，重启后即可看到核心初始化时的详细错误栈。

• Lib标签加载顺序错误：如果solrconfig.xml中的<lib>标签放置位置过晚（比如在<schemaFactory>或<schema>导入之后），会导致schema初始化时插件Jar还未被加载，进而找不到Factory类。需将<lib>标签放在solrconfig.xml的最开头部分。

• 文件权限问题：Solr运行用户对${SOLR_HOME}\lib\custom目录或Jar包没有读取权限，导致无法加载插件文件。需检查并调整目录及文件的读写权限。

• 插件依赖缺失或冲突：自定义插件可能依赖Lucene的特定类，但如果打包时未正确包含必要依赖，或者依赖的Lucene类与Solr内置的版本冲突，会导致类加载失败。建议使用maven-shade-plugin等工具打包时处理依赖，并确保依赖版本与Solr内置Lucene一致。

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