Logstash v7.15.1 无法启动pipeline 报Java NoSuchMethodError错误排查求助

根因分析 #

本次报错的核心原因是Java版本兼容问题，额外可能和误删核心组件有关：

• 报错中提到的java.nio.MappedByteBuffer.position(I)Ljava/nio/MappedByteBuffer;方法是JDK 9及以上版本才支持的协变返回实现，JDK 8中该方法的返回值为java.nio.Buffer，方法签名不匹配就会抛出NoSuchMethodError异常。
• Logstash 7.15.1官方默认适配的运行时JDK为安装包自带的OpenJDK 11，若手动指定JDK 8作为运行环境，或者系统默认Java版本为JDK 8，就会触发该错误。
• 手动移除自带插件时如果误删了队列、核心运行类相关的依赖组件，也会触发这类运行时异常。

解决方案 #

• 优先使用Logstash自带JDK运行：直接执行安装目录下的bin/logstash启动脚本即可，脚本默认会调用内置的兼容JDK环境，无需额外配置系统Java变量。
  若需手动指定JDK版本，选择LTS版JDK 11即可，不要使用JDK 8、JDK 9/10这类非兼容版本。
• 恢复误删的核心组件：如果确认是删除插件后才出现的问题，重新解压同版本的Logstash安装包，仅删除确认和业务无关的非核心插件，不要删除logstash-core、持久化队列相关的内置组件。
• 临时验证方案：如果需要快速验证服务可用性，可以修改config/logstash.yml中的队列配置，临时关闭持久化队列测试启动：

  queue.type: memory
  

  该方案仅适用于临时测试，生产环境若需要队列持久化能力不建议长期使用。

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