部署至Kubernetes后，使用ImageIO读取多页TIFF文件失败

问题描述 #

我开发了一款Java程序，功能是将多页文件转换为独立图像文件。本地运行时功能完全正常，但部署到Kubernetes环境后却无法正常工作——有时无任何错误输出，有时会抛出如下异常：

java.io.IOException: No image reader found for file: /file/25-04-2023/001.tif
at com.test.ms.test.Scheduled.ScheduledOcrJob.convertMultipageFile(ScheduledOcrJob.java:161) ~[classes!/:0.0.1]
at com.test.ms.test.Scheduled.ScheduledOcrJob.convertFilesInDirectory(ScheduledOcrJob.java:130) ~[classes!/:0.0.1]
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.0_342]
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:1.8.0_342]
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_342]
at java.lang.reflect.Method.invoke(Method.java:498) ~[na:1.8.0_342]
at org.springframework.scheduling.support.ScheduledMethodRunnable.run(ScheduledMethodRunnable.java:84) ~[spring-context-5.2.3.RELEASE.jar!/:5.2.3.RELEASE]
at org.springframework.scheduling.support.DelegatingErrorHandlingRunnable.run(DelegatingErrorHandlingRunnable.java:54) ~[spring-context-5.2.3.RELEASE.jar!/:5.2.3.RELEASE]
at org.springframework.scheduling.concurrent.ReschedulingRunnable.run(ReschedulingRunnable.java:93) [spring-context-5.2.3.RELEASE.jar!/:5.2.3.RELEASE]
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) [na:1.8.0_342]
at java.util.concurrent.FutureTask.run(FutureTask.java:266) [na:1.8.0_342]
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180) [na:1.8.0_342]
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293) [na:1.8.0_342]
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) [na:1.8.0_342]
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) [na:1.8.0_342]
at java.lang.Thread.run(Thread.java:750) [na:1.8.0_342]

核心转换代码如下：

private void convertMultipageFile(File file) throws IOException {
    String directoryPath = file.getParent();
    log.info(directoryPath);
    log.info(String.valueOf(file));
    String fileType = "";
    ImageIO.scanForPlugins();
    ImageInputStream input = ImageIO.createImageInputStream(file);
    Iterator<ImageReader> readers = ImageIO.getImageReaders(input);
    if (!readers.hasNext()) {
        throw new IOException("No image reader found for file: " + file);
    }
    ImageReader reader = readers.next();
    reader.setInput(input);
    int numPages = reader.getNumImages(true);
    String fileName = file.getName().substring(0, file.getName().lastIndexOf('.'));
    String fileExt = file.getName().substring(file.getName().lastIndexOf('.') + 1);
    for (int i = 0; i < numPages; i++) {
        BufferedImage image = reader.read(i);
        ByteArrayOutputStream output = new ByteArrayOutputStream();
        ImageIO.write(image, "tif", output);
        byte[] pageBytes = output.toByteArray();
        output.close();
        fileType = calculateOCR(pageBytes);
        log.info(fileType);
        if (fileType.contains("AnaBelge")) {
            String belgeName = fileType.split(",")[1] + "." + fileExt;
            String folderName = fileType.split(",")[1];
            directoryPath = file.getParent() + "/" + folderName;
            File directory = new File(directoryPath);
            if (!directory.exists()) {
                boolean created = directory.mkdir();
                if (created) {
                    File newFile = new File(directoryPath, belgeName);
                    ImageIO.write(image, fileExt, newFile);
                } else {
                    log.warn("Failed to create directory.");
                }
            }
        } else {
            String newFileName = fileName + "_page" + (i + 1) + fileType + "." + fileExt;
            File newFile = new File(directoryPath, newFileName);
            ImageIO.write(image, fileExt, newFile);
        }
    }
}

排查思路 #

• 镜像依赖检查：本地环境可能自带TIFF格式的ImageIO插件，但Kubernetes使用的基础镜像可能缺失对应的插件或系统依赖库。
• 文件权限验证：确认Pod运行用户对目标文件/file/25-04-2023/001.tif有读取权限，权限不足可能导致文件读取异常，被误判为阅读器缺失。
• 文件完整性确认：对比本地测试文件与K8s挂载文件的MD5哈希值，排查是否存在文件传输或存储过程中的损坏。
• SPI加载问题排查：ImageIO插件通过SPI机制加载，检查打包后的JAR是否包含META-INF/services/javax.imageio.spi.ImageReaderSpi文件，以及K8s环境下是否存在类加载路径冲突。
• 多线程安全检查：ImageIO.scanForPlugins()并非线程安全方法，若程序多线程并发执行定时任务，可能导致插件加载不完整。

解决方案 #

1. 补充TIFF ImageIO依赖 #

若基础镜像无自带TIFF阅读器，在项目pom.xml中添加第三方依赖：

<dependency>
    <groupId>com.twelvemonkeys.imageio</groupId>
    <artifactId>imageio-tiff</artifactId>
    <version>3.10.1</version>
</dependency>

该依赖会自动注册TIFF的ImageReader SPI，确保打包后包含对应的服务配置文件。

2. 修复文件权限问题 #

• 在K8s的Volume挂载配置中，通过securityContext指定Pod运行用户，或使用initContainer提前修改挂载目录的权限，确保程序用户有文件读取权限。
• 在代码中添加文件状态校验日志，提前排查文件访问问题：

log.info("File exists: {}, readable: {}", file.exists(), file.canRead());

3. 确保文件完整性 #

在文件上传至K8s存储后，添加MD5校验步骤，对比本地与K8s环境的文件哈希值，确认文件未损坏。

4. 修复SPI线程安全问题 #

• 将ImageIO.scanForPlugins()移至程序启动初始化逻辑（如Spring的@PostConstruct方法），仅执行一次，避免多线程重复加载异常。
• 确认Spring Boot打包时正确合并META-INF/services目录下的SPI配置文件，保证TIFF阅读器实现类被正确注册。

5. 显式指定TIFF阅读器 #

若自动SPI扫描不稳定，可直接指定TIFF格式阅读器，跳过自动检测：

// 按格式名指定阅读器
Iterator<ImageReader> readers = ImageIO.getImageReadersByFormatName("TIFF");
// 或按文件后缀指定
// Iterator<ImageReader> readers = ImageIO.getImageReadersBySuffix("tif");

内容的提问来源于stack exchange，提问作者Altan Mehmet TÜrkmen