SOLR 9.1.0核心无法加载问题求助（附报错日志）

根因确认 #

从提供的日志中，底层异常java.nio.channels.OverlappingFileLockException是核心问题：Solr尝试获取索引目录的文件锁时，发现已有重叠锁存在，导致核心初始化失败。重启临时恢复是因为重启释放了旧锁，但残留进程或异常锁文件会导致问题复发。

排查与修复步骤 #

• 清理残留进程
  检查服务器上是否有未正常退出的Solr相关Java进程，执行命令：

  ps aux | grep solr
  # 或用jps查找Java进程
  jps -l | grep solr
  

  找到残留进程后，强制终止：kill -9 <进程ID>
  集群环境需确认无跨节点进程访问同一核心索引目录。

• 删除残留锁文件
  定位到故障核心的索引目录（通常为${SOLR_HOME}/data/<核心名>/index），删除目录下的write.lock文件。操作前必须确保无任何进程读写该索引目录，避免损坏数据。

• 调整锁工厂配置
  默认的NativeFSLockFactory在部分环境（如共享存储、高并发场景）易出现锁冲突，可修改核心的solrconfig.xml：

  <!-- 替换原有lockFactory节点 -->
  <lockFactory class="org.apache.lucene.store.SimpleFSLockFactory"/>
  

  单机环境也需排查是否有第三方工具（备份脚本、索引分析程序）在访问索引目录。

• 检查磁盘状态
  用以下命令检查磁盘空间、inode使用情况，排除IO瓶颈或文件系统异常：

  df -h # 检查磁盘空间
  df -i # 检查inode数量
  

• 升级Solr版本
  Solr 9.1.0存在锁机制相关的已知问题，后续9.2.0及以上版本有修复，建议升级至稳定版本。

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