[bug]: PatchMatch fails to load due to libtiff/libjpeg ABI mismatch (jpeg12_* unresolved at runtime)

问题场景

用户通过 InvokeAI Launcher 启动 InvokeAI 6.13 AppImage，在 CPU 模式下初始化 PatchMatch 时，日志出现 undefined symbol: jpeg12_write_raw_data，随后 InvokeAI 提示 “Patchmatch not loaded (nonfatal)”，inpainting 功能无法使用。该问题在 openSUSE Tumbleweed 上同样被其他用户反馈过（有的用户遇到的是 libopencv_aruco.so.412 与 .413 不匹配）。

报错原文

[bug]: PatchMatch fails to load due to libtiff/libjpeg ABI mismatch (jpeg12_* unresolved at runtime)

>> patchmatch.patch_match: ERROR - patchmatch failed to load or compile (/lib64/libtiff.so.6: undefined symbol: jpeg12_write_raw_data, version LIBJPEG_8.0).
>> patchmatch.patch_match: INFO - Refer to https://invoke-ai.github.io/InvokeAI/installation/060_INSTALL_PATCHMATCH/ for installation instructions.
[2026-06-12 11:47:33,311]::[InvokeAI]::INFO --> Patchmatch not loaded (nonfatal)

原因分析

可能原因：系统 libtiff 在编译时预期使用完整集成 jpeg12_* 符号的 libjpeg-turbo ABI，但运行时符号解析失败。尽管 libjpeg-turbo 确实导出了 jpeg12_write_raw_data@LIBJPEG_8.0（由 objdump/readelf 验证），崩溃仍发生，说明并非单纯缺少依赖，而是 ABI 特性不匹配或运行时加载了错误版本的库。另一个可能原因是 InvokeAI AppImage 内嵌的 OpenCV 使用自带 TIFF 后端，但 PatchMatch 路径仍解析到系统 libtiff，形成库栈冲突。

环境排查

• 操作系统版本：openSUSE Tumbleweed / Leap
• InvokeAI 版本：6.13.0 AppImage
• Python 版本：3.12（venv 也已测试）
• OpenCV 版本：4.13.0
• libtiff 版本：4.7.1
• libjpeg-turbo 版本：3.0.4
• CPU：x86-64-v3（glibc hwcaps enabled）
• 需要确认系统中是否同时存在多个 libtiff/libjpeg 副本，以及 AppImage 实际加载的是哪个路径

解决步骤

1. 先确认当前系统 libtiff 与 libjpeg 版本：ldconfig -p | grep libtiff 和 ldconfig -p | grep libjpeg，记录实际库路径。
2. 检查符号是否存在于 libjpeg-turbo 中：nm -D /usr/lib64/libjpeg.so.8 | grep jpeg12_write_raw_data 或使用 readelf 验证。
3. 尝试重新安装 libjpeg-turbo 与 libtiff（Issue 中已测试无效，但可排除本地包损坏）。
4. 尝试通过 LD_LIBRARY_PATH 强制指定与 libtiff 匹配的 libjpeg 路径（Issue 中已测试无效）。
5. 尝试设置 LD_HWCAP_MASK=0x0 禁用 hwcaps（Issue 中已测试无效）。
6. 如果以上都无效，可关注 Invoke
   

   参考来源

   invoke-ai/InvokeAI #9287

   

   AI 工具推荐

   想把多个 AI 模型放在一个入口？

   GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

   了解 GamsGo AI

   推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

   这个方案解决了吗？

   解决了还没有