Linux下构建Java版MuPDF遇UnsatisfiedLinkError，求多语言PDF文本提取方案

问题复现流程 #

• 下载MuPDF项目
• 执行构建与运行命令：

  make -C platform/java examples
  java -classpath build/java/debug -Djava.library.path=build/java/debug example.Example document.pdf 2
  

• 首次报错：

  java.lang.UnsatisfiedLinkError: no mupdf_java64
  

• 修改System.loadLibrary()参数为libjmupdf64.so后，出现新错误：

  java.lang.UnsatisfiedLinkError: 'int com.artifex.mupdf.fitz.Context.initNative()'

问题处理方案 #

针对首次报错 #

• Java加载本地库时会自动添加Linux系统对应的前缀（lib）和后缀（.so），无需手动修改System.loadLibrary()的参数，保持System.loadLibrary("mupdf_java64")即可。
• 确认build/java/debug目录下是否生成了libmupdf_java64.so文件，若未生成，执行make -C platform/java clean后重新构建，检查构建日志是否有编译错误。

针对修改库名后的报错 #

• 手动指定完整库文件名会导致JNI方法签名不匹配，因为库内部导出的JNI方法是与原库名绑定的，必须使用mupdf_java64作为加载参数才能正确关联JNI方法。
• 检查platform/java/jni目录下的JNI绑定代码是否正确生成，构建过程中是否有JNI相关的编译警告或错误。

多语言PDF文本提取替代工具推荐 #

• Apache PDFBox：开源Java库，对多语言文本编码支持较好，能处理大部分复杂PDF的文本提取需求，API简洁易用。
• iText：功能全面的PDF处理库，支持多语言文本提取，兼容多种PDF格式，提供丰富的文档操作能力，分为社区版和商业版。
• PDFClown：轻量级开源库，采用面向对象设计，支持多语言，适合简单到中等复杂度的PDF文本提取场景。

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