.HEIC格式图片HTTP传输方向异常及EXIF读取失败求助

核心问题 #

github.com/rwcarlsen/goexif/exif 库仅支持解析JPEG、TIFF等传统图像格式的EXIF数据，不支持HEIC（HEIF容器）格式。HEIC的EXIF数据嵌入在HEIF容器内部，无法被该库直接解码，所以你会得到exifData is nil的结果。

解决方案 #

使用支持HEIF容器的库提取HEIC的EXIF数据，推荐github.com/strukturag/libheif-go，它可以解析HEIC的元数据（包括方向信息）。以下是修改后的完整实现：

1. 安装依赖 #

• 系统依赖：Ubuntu/Debian执行apt-get install libheif-dev；macOS执行brew install libheif
• Go库：go get github.com/strukturag/libheif-go

2. 修改后的代码 #

import (
	"bytes"
	"io"

	"github.com/gofiber/fiber/v2"
	"github.com/rwcarlsen/goexif/exif"
	"github.com/strukturag/libheif-go"
)

// ParseFileToBytes 读取form-data文件并返回字节数据与图像方向
func ParseFileToBytes(c *fiber.Ctx, fileName string) ([]byte, int, error) {
	if c.Method() != fiber.MethodPatch {
		return nil, 0, errlst.HttpErrInvalidRequest
	}

	formFile, err := c.FormFile(fileName)
	if err != nil {
		return nil, 0, err
	}

	file, err := formFile.Open()
	if err != nil {
		return nil, 0, err
	}
	defer file.Close()

	fileData, err := io.ReadAll(file)
	if err != nil {
		return nil, 0, err
	}

	// 默认方向：1（正常显示）
	orientation := 1

	// 判断是否为HEIC/HEIF格式（优先用文件头magic number，比扩展名可靠）
	if isHEIC(fileData) {
		ctx := libheif.NewContext()
		if err := ctx.ReadFromMemory(fileData); err != nil {
			logger.Log.Info("HEIC解析失败: ", err)
			return fileData, orientation, nil
		}

		imgHandle, err := ctx.GetPrimaryImageHandle()
		if err != nil {
			logger.Log.Info("获取HEIC主图像失败: ", err)
			return fileData, orientation, nil
		}

		// 提取HEIC中的EXIF数据并解析方向
		exifRaw, err := imgHandle.GetExif()
		if err == nil && exifRaw != nil {
			exifTags, err := exif.Decode(bytes.NewReader(exifRaw))
			if err == nil {
				orientTag, err := exifTags.Get(exif.Orientation)
				if err == nil {
					if val, err := orientTag.Int(0); err == nil {
						orientation = val
					}
				}
			}
		} else {
			// fallback：通过图像尺寸判断（仅作补充，优先依赖EXIF）
			width, height := imgHandle.GetWidth(), imgHandle.GetHeight()
			if height > width {
				orientation = 6 // 对应iPhone竖屏拍摄的顺时针90度旋转
			}
		}
	} else {
		// 其他格式用goexif解析方向
		exifTags, err := exif.Decode(bytes.NewReader(fileData))
		if err == nil && exifTags != nil {
			orientTag, err := exifTags.Get(exif.Orientation)
			if err == nil {
				if val, err := orientTag.Int(0); err == nil {
					orientation = val
				}
			}
		}
	}

	logger.Log.Info("图像方向值: ", orientation)
	return fileData, orientation, nil
}

// isHEIC 通过文件头magic number判断是否为HEIC格式
func isHEIC(data []byte) bool {
	if len(data) < 12 {
		return false
	}
	// HEIC的文件头标识为ftyp后跟随heic/heix/heim/heis等
	ftype := string(data[4:8])
	return ftype == "heic" || ftype == "heix" || ftype == "heim" || ftype == "heis"
}

3. 方向值说明 #

EXIF方向值对应场景：

• 1：正常（横屏）
• 6：顺时针旋转90度（iPhone竖屏拍摄的照片通常为此值）
• 8：逆时针旋转90度
• 3：旋转180度

后续存储时，可根据该方向值对图像进行旋转校正，避免出现侧躺显示的问题。

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