Java iText中Image.getInstance(url)获取图像出现旋转的原因

核心原因 #

• EXIF方向元数据未被自动处理：绝大多数情况是图片的EXIF信息里包含了Orientation（方向）标记，比如手机竖屏拍摄的照片，会在EXIF中存储“需要顺时针旋转90度”这类指令。普通图片查看器、浏览器会自动读取这个标记并调整显示方向，但iText的Image.getInstance()（尤其是iText 5及更早版本）默认不会解析并应用这个旋转规则，导致图片按原始像素方向渲染，看起来就像是旋转了。

其他可能原因 #

• 旧版iText的兼容性问题：早期iText版本对部分EXIF方向标记的解析支持不完善，即使图片有标准的方向元数据也无法正确识别。
• 图片格式的特殊编码：极少数情况下，图片的像素存储方向与视觉预期不一致，仅靠查看器的自动适配才显示正常，但这种情况概率极低。

解决方法 #

1. 手动解析EXIF并调整图片（适用于iText 5） #

借助第三方库读取EXIF的方向值，再对iText Image对象进行旋转调整，示例代码如下（以Apache Commons Imaging为例）：

URL imgUrl = new URL("你的图片URL");
byte[] imgBytes = IOUtils.toByteArray(imgUrl.openStream());
Image img = Image.getInstance(imgBytes);

// 读取EXIF方向标记
Metadata metadata = ImageMetadataReader.readMetadata(new ByteArrayInputStream(imgBytes));
ExifIFD0Directory exifDir = metadata.getFirstDirectoryOfType(ExifIFD0Directory.class);
if (exifDir != null && exifDir.containsTag(ExifIFD0Directory.TAG_ORIENTATION)) {
    int orientation = exifDir.getInt(ExifIFD0Directory.TAG_ORIENTATION);
    switch (orientation) {
        case 6: // 需顺时针转90度
            img.setRotationDegrees(90);
            break;
        case 8: // 需逆时针转90度
            img.setRotationDegrees(-90);
            break;
        case 3: // 需转180度
            img.setRotationDegrees(180);
            break;
        // 其他方向值可根据实际需求补充处理
    }
}

2. 升级到iText 7（推荐） #

iText 7的ImageDataFactory会自动识别并应用EXIF方向元数据，无需额外处理，代码更简洁：

URL imgUrl = new URL("你的图片URL");
ImageData imageData = ImageDataFactory.create(imgUrl);
Image img = new Image(imageData);
// 图片会自动按正确方向渲染

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