ImageIO 3.3.2升级3.8.2时TIFF元数据不兼容问题咨询

TwelveMonkeys ImageIO 3.8.x版本的TIFF写入插件补全了API规范校验逻辑：prepareWriteSequence 方法仅接收流级别元数据（TIFFStreamMetadata类型），这类元数据用于定义整个TIFF文件的全局属性；你之前传入的TIFFImageMetadata是单帧/单页级别的图像元数据，作用域是单个图像页，不属于流元数据范畴，因此触发格式不匹配报错。3.3.x版本未做严格的类型与格式校验，属于非规范的宽松实现，升级后才会暴露参数传错的问题。

• 调整参数传递位置：prepareWriteSequence 无特殊流配置需求时直接传入null，插件会自动生成符合标准的默认TIFF流元数据；你之前自定义的分辨率、生成时间、软件标识这类属性全部属于单页图像元数据，不需要修改生成逻辑，只要在调用writeToSequence写入每一页时，绑定到IIOImage对象上传入即可。
• 不需要做元数据格式转换：TIFFStreamMetadata和TIFFImageMetadata是作用域完全独立的两类元数据，不存在兼容转换逻辑，之前旧版本允许传图像元数据本身就是不符合ImageIO接口规范的行为。

修改后的可运行代码示例：

// 1. 初始化写入序列，无特殊流配置直接传null
try (ImageOutputStream ios = ImageIO.createImageOutputStream(outFile)) {
    ImageWriter tifWriter = ImageIO.getImageWritersByFormatName("TIFF").next();
    tifWriter.setOutput(ios);
    
    // 修正原错误传参
    tifWriter.prepareWriteSequence(null);

    // 2. 循环写入多页TIFF，单页场景直接写入一次即可
    for (BufferedImage pageImage : pageList) {
        // 原有getTifMetadata()方法逻辑完全不需要改动
        IIOMetadata pageMetadata = getTifMetadata();
        // 将图像元数据绑定到IIOImage，作为帧级元数据传入
        IIOImage iioImage = new IIOImage(pageImage, null, pageMetadata);
        tifWriter.writeToSequence(iioImage, null);
    }

    tifWriter.endWriteSequence();
}

特殊场景说明：如果需要自定义全局流属性（比如强制指定TIFF字节序、配置全局IFD存储偏移规则），可以调用tifWriter.getDefaultStreamMetadata(null)获取默认的TIFFStreamMetadata实例，修改对应属性后再传入prepareWriteSequence即可，不要尝试将TIFFImageMetadata转成流元数据使用。

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