Gin后端集成govips遇VipsJpeg版本不匹配错误，脚本运行正常

在Gin后端服务器中使用github.com/davidbyttow/govips处理JPEG图片时，触发错误：

VipsJpeg: Wrong JPEG library version: library is 90, caller expects 80

但相同代码作为独立脚本运行时完全正常。

复现步骤 #

• 启动集成了github.com/davidbyttow/govips的Gin后端服务器
• 在服务器中尝试处理JPEG图片

预期与实际行为 #

• 预期：服务器正常运行，无JPEG版本不匹配错误
• 实际：触发VipsJpeg版本冲突错误

环境信息 #

• govips版本：vips-8.15.0
• 操作系统：Ubuntu 22.04.1 arm64
• Go版本：go1.22.2

示例代码 #

vips.Startup(nil)
defer vips.Shutdown()

daata, _ := os.ReadFile("sample.jpg")

inputImage, err := vips.NewImageFromBuffer(daata)
checkError(err)
defer inputImage.Close()
checkError(inputImage.OptimizeICCProfile())

ep := vips.NewJpegExportParams()
ep.StripMetadata = true
ep.Quality = 75
ep.Interlace = true
ep.OptimizeCoding = true
ep.SubsampleMode = vips.VipsForeignSubsampleAuto
ep.TrellisQuant = true
ep.OvershootDeringing = true
ep.OptimizeScans = true
ep.QuantTable = 3

imageBytes, _, err := inputImage.ExportJpeg(ep)
checkError(err)
checkError(os.WriteFile("optim.jpg", imageBytes, 0644))

日志对比 #

独立脚本运行日志 #

2024/04/29 11:41:12 [VIPS.info] found /usr/local/lib/aarch64-linux-gnu/vips-modules-8.15
2024/04/29 11:41:12 [VIPS.info] using configure-time prefix
2024/04/29 11:41:12 [VIPS.info] VIPS_PREFIX = /usr/local
2024/04/29 11:41:12 [VIPS.info] VIPS_LIBDIR = /usr/local/lib/aarch64-linux-gnu
2024/04/29 11:41:12 [VIPS.info] prefix = /usr/local
2024/04/29 11:41:12 [VIPS.info] libdir = /usr/local/lib/aarch64-linux-gnu
2024/04/29 11:41:12 [VIPS.info] searching "/usr/local/lib/aarch64-linux-gnu/vips-modules-8.15"
2024/04/29 11:41:12 [VIPS.info] loading "/usr/local/lib/aarch64-linux-gnu/vips-modules-8.15/vips-openslide.so"
2024/04/29 11:41:12 [VIPS.info] loading "/usr/local/lib/aarch64-linux-gnu/vips-modules-8.15/vips-heif.so"
2024/04/29 11:41:12 [VIPS.info] loading "/usr/local/lib/aarch64-linux-gnu/vips-modules-8.15/vips-magick.so"
2024/04/29 11:41:12 [VIPS.info] loading "/usr/local/lib/aarch64-linux-gnu/vips-modules-8.15/vips-poppler.so"
2024/04/29 11:41:12 [VIPS.info] searching "/usr/local/lib/aarch64-linux-gnu/vips-plugins-8.15"
2024/04/29 11:41:12 [govips.info] vips 8.15.0 started with concurrency=1 cache_max_files=0 cache_max_mem=52428800 cache_max=100
2024/04/29 11:41:12 [govips.info] registered image type loader type=tiff
2024/04/29 11:41:12 [govips.info] registered image type loader type=heif
2024/04/29 11:41:12 [govips.info] registered image type loader type=heif
2024/04/29 11:41:12 [govips.info] registered image type loader type=svg
2024/04/29 11:41:12 [govips.info] registered image type loader type=jpeg
2024/04/29 11:41:12 [govips.info] registered image type loader type=magick
2024/04/29 11:41:12 [govips.info] registered image type loader type=pdf
2024/04/29 11:41:12 [govips.info] registered image type loader type=png
2024/04/29 11:41:12 [govips.info] registered image type loader type=webp
2024/04/29 11:41:12 [govips.info] registered image type loader type=jp2k
2024/04/29 11:41:12 [govips.info] registered image type loader type=gif

Gin后端服务器日志 #

2024/04/30 05:45:51 [govips.info] vips 8.15.0 started with concurrency=1 cache_max_files=0 cache_max_mem=52428800 cache_max=100
2024/04/30 05:45:51 [govips.info] registered image type loader type=tiff
2024/04/30 05:45:51 [govips.info] registered image type loader type=webp
2024/04/30 05:45:51 [govips.info] registered image type loader type=heif
2024/04/30 05:45:51 [govips.info] registered image type loader type=gif
2024/04/30 05:45:51 [govips.info] registered image type loader type=magick
2024/04/30 05:45:51 [govips.info] registered image type loader type=svg
2024/04/30 05:45:51 [govips.info] registered image type loader type=heif
2024/04/30 05:45:51 [govips.info] registered image type loader type=jp2k
2024/04/30 05:45:51 [govips.info] registered image type loader type=jpeg
2024/04/30 05:45:51 [govips.info] registered image type loader type=pdf
2024/04/30 05:45:51 [govips.info] registered image type loader type=png

解决方法 #

这个问题本质是动态库加载顺序冲突：Gin后端依赖的其他库（比如图像处理中间件、数据库驱动等）先加载了旧版本libjpeg（对应版本号80），导致govips启动时无法加载编译时依赖的新版本libjpeg（对应版本号90）。

具体操作 #

1. 确认系统libjpeg版本
   执行以下命令查看已安装的libjpeg库：

   ldconfig -p | grep libjpeg
   

   会看到类似libjpeg.so.8（版本80）和libjpeg.so.9（版本90）的条目。

2. 强制优先加载新版本libjpeg

   • 启动服务器时通过环境变量指定：

     LD_PRELOAD=/usr/local/lib/aarch64-linux-gnu/libjpeg.so.9 ./your-gin-server-binary
     

   • 或在Go代码main函数最开头设置：

     import "os"
     
     func main() {
         os.Setenv("LD_PRELOAD", "/usr/local/lib/aarch64-linux-gnu/libjpeg.so.9")
         // 初始化Gin等后续代码
     }
     

3. 重新编译govips确保依赖一致
   若上述方法无效，重新编译govips并明确指定链接新版本libjpeg：

   go get -u github.com/davidbyttow/govips/v2@vips-8.15.0
   CGO_LDFLAGS="-L/usr/local/lib/aarch64-linux-gnu -ljpeg" go build -o your-gin-server .
   

4. 排查依赖冲突
   用ldd命令检查服务器二进制的依赖：

   ldd ./your-gin-server-binary | grep jpeg
   

   若发现依赖旧版本libjpeg，尝试更新对应库到兼容新版本的版本。

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