Apache Tika 2.9.0无法找到ffmpeg和exiftool的排查求助

以下是针对问题的具体排查步骤：

1. 确认tika-config.xml的配置格式匹配Tika 2.x规范 #

Tika 2.x对外部工具路径的配置需针对具体解析器指定参数，而非全局属性。检查你的配置是否符合如下格式：

<?xml version="1.0" encoding="UTF-8"?>
<tika-config xmlns="http://tika.apache.org/config/1.0">
  <parsers>
    <!-- 配置FFmpeg路径 -->
    <parser class="org.apache.tika.parser.video.FFParser">
      <params>
        <param name="ffmpegPath" type="string" value="/absolute/path/to/ffmpeg"/>
      </params>
    </parser>
    <!-- 配置ExifTool路径 -->
    <parser class="org.apache.tika.parser.image.ExifToolParser">
      <params>
        <param name="exiftoolPath" type="string" value="/absolute/path/to/exiftool"/>
      </params>
    </parser>
  </parsers>
</tika-config>

注意：Windows系统下路径需用双反斜杠转义，例如C:\\Program Files\\ffmpeg\\ffmpeg.exe。

2. 验证代码中配置加载的正确性 #

在测试代码中添加如下片段，确认Tika实际读取到的路径与配置一致：

import org.apache.tika.config.TikaConfig;
import org.apache.tika.parser.image.ExifToolParser;
import org.apache.tika.parser.video.FFParser;

public class TikaConfigTest {
    public static void main(String[] args) throws Exception {
        // 加载自定义配置文件，若放在resources下可直接用类路径
        TikaConfig config = new TikaConfig("/absolute/path/to/tika-config.xml");
        
        // 检查FFmpeg路径
        FFParser ffParser = config.getParser(FFParser.class);
        System.out.println("实际加载的FFmpeg路径: " + ffParser.getFfmpegPath());
        
        // 检查ExifTool路径
        ExifToolParser exifParser = config.getParser(ExifToolParser.class);
        System.out.println("实际加载的ExifTool路径: " + exifParser.getExiftoolPath());
    }
}

如果输出为空或与配置不符，说明配置文件未被正确加载，需检查配置文件的读取路径是否正确。

3. 排查Maven依赖完整性 #

确保pom.xml中引入了包含对应解析器的依赖包，避免因依赖缺失导致解析器未初始化：

<dependency>
    <groupId>org.apache.tika</groupId>
    <artifactId>tika-parsers-standard-package</artifactId>
    <version>2.9.0</version>
</dependency>

若仅引入核心包，可能缺少FFParser和ExifToolParser的实现类。

4. 检查JavaFX运行环境的路径上下文 #

JavaFX应用在不同运行模式（IDE启动、打包后启动）下的工作目录可能不同，可在代码中打印当前工作目录确认：

System.out.println("当前工作目录: " + System.getProperty("user.dir"));

确保配置的绝对路径没有因环境差异被错误解析（比如路径中包含空格但未转义，不过绝对路径一般不存在此问题）。

5. 分析DEBUG日志的具体错误细节 #

仔细查看日志中"无法找到工具"的具体描述：

• 若日志显示尝试调用的是ffmpeg/exiftool而非你配置的全路径，说明配置未生效，回到步骤1和2检查配置格式与加载逻辑；
• 若日志显示的路径与你配置的一致但仍提示找不到，需再次验证该路径在JavaFX运行环境中的可访问性（比如打包后是否存在权限限制，或路径中特殊字符导致解析错误）。

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