تختفي معاينات HEIC عندما يتعذر على المعرض فك ترميز الملف الأصلي، أو إنشاء صورته المشتقة، أو تسليم تلك الصورة إلى العميل الحالي.
يحافظ المعرض المستضاف ذاتيًا عادةً على ملف HEIC الأصلي، مع إنشاء صور مصغرة ومعاينات بتنسيق JPEG أو WebP للمتصفحات والهواتف التي قد لا تعرض كل ملفات تعريف HEIF مباشرةً. ويمكن أن يظل الملف الأصلي قابلًا للتنزيل حتى عندما يكون المخطط الزمني فارغًا، لأن التلف أو ملف تعريف ترميز جديد من الهاتف أو الأبعاد الكبيرة جدًا أو عدم دعم وحدة فك الترميز أو فشل مهام العامل أو سجلات الصور المصغرة القديمة أو تحميل الملف الأصلي من جهة العميل قد يؤثر فقط في مسار الصور المشتقة. شخّص ملفًا واحدًا بدءًا من البايتات الأصلية ووصولًا إلى المعاينة المُنشأة.
تأكد من سلامة ملف HEIC الأصلي
نزّل الملف الأصلي من المعرض، ثم قارن حجمه وبصمته مع المصدر الموجود على الهاتف أو ملف التصدير أو النسخة الاحتياطية. وافتحه في تطبيق موثوق على سطح المكتب يدعم HEIC.
أفاد مستخدمو Immich عن ملفات HEIC وDNG مرفوعة توقفت بعدها الصور المصغرة والمعاينات عن الإنشاء، ما يجعل من المهم التمييز بين تلف الملف الأصلي وفشل مسار الصور المشتقة. وكان العَرَض الظاهر هو اختفاء الصور المصغرة بعد الرفع.
إذا كان الملف الأصلي الذي نزّلته مبتورًا أو تالفًا، فأصلح مسار النقل وأعد رفعه من مصدر تم التحقق منه. وإذا فُتح الملف الأصلي بشكل صحيح، فاحتفظ به وتابع فحوصات البيانات الوصفية ووحدة فك الترميز والمهام.
قارن البيانات الوصفية لملفَي HEIC يعمل أحدهما ويفشل الآخر
اختر ملف HEIC واحدًا تُنشأ له المعاينات وملفًا آخر لا تُنشأ له. قارن طراز الجهاز، وإصدار نظام التشغيل، والأبعاد، وعمق الألوان، وملف تعريف الألوان، والصور المساعدة، والاتجاه، والبيانات الوصفية لـ HDR، وحجم الملف، والعلامات التجارية للحاوية.
قد تُدخل برامج الهواتف الجديدة ملف تعريف لا تفهمه وحدة فك الترميز الحالية على الخادم. وقد وجدت إحدى مشكلات Immich أن ملفات HEIC من iOS 18 تفشل في إنشاء الصور المصغرة مع رسائل تشير إلى رؤوس غير صحيحة، بينما تظل صور iOS الأقدم تعمل، ما عزل اختلافًا جديدًا في ملف المصدر.
اختبر صورة أخرى من الهاتف نفسه بعد تغيير إعداد الكاميرا، وذلك لأغراض تصنيف العطل فقط. لا تحوّل المكتبة الأصلية أو تستبدلها قبل معرفة ملف التعريف غير المتوافق وإصدار الخادم.
تحقق من أبعاد الصور وحدود الموارد
سجّل عرض الصورة الفاشلة وارتفاعها وعدد ميغابكسلاتها وحجم ملفها والصور المساعدة المضمّنة فيها. فقد تتطلب ملفات HEIC الكبيرة جدًا ذاكرة أكبر بكثير أثناء فك الترميز مما يوحي به حجمها المضغوط.
وثّقت Immich ملفات HEIC كبيرة بحجم 200 ميغابكسل لم تتمكن من إنتاج صور مصغرة أو عرض معاينات لها. وكان الحد العملي هو الأبعاد الكبيرة للغاية لملفات HEIC، وليس التصفح العادي للمعرض.
راقب ذاكرة عامل الصور المصغرة ووحدة المعالجة المركزية وحدود الحاوية وأحداث نفاد الذاكرة أثناء معالجة ملف واحد. وإذا كانت صور HEIC الأصغر تعمل، فارفع موارد العامل المدعومة أو احتفظ بنسخة معاينة متوافقة دون التخلي عن الملف الأصلي بالدقة الكاملة.
اقرأ أول خطأ في فك الترميز يظهر في سجل عامل الصور المصغرة
شغّل مهمة الصور المصغرة المفقودة أو إعادة الإنشاء لأصل واحد متأثر، وتابع سجل الخدمة المصغّرة أو العامل. التقط أول خطأ متعلق بوحدة فك الترميز أو الرأس أو مساحة الألوان أو الأذونات أو الكتابة، بدلًا من الفشل العام النهائي.
تستمر التقارير الحديثة من Immich في إظهار فشل إنشاء الصور المصغرة لملفات HEIC محددة بعد التحديثات. وتحدد إحدى مشكلات عام 2026 فشلًا في معالجة HEIC مرتبطًا بالتحديث.
إذا فشل كل ملف جديد بعد أول خطأ متعلق بـ HEIC، فأعد تشغيل العامل الفاشل فقط بعد حفظ السجلات، وتحقق من سلامة قائمة الانتظار. ولا تسمح لملف واحد تالف بإخفاء ما إذا كانت عملية العامل نفسها قد توقفت عن إنشاء جميع المعاينات اللاحقة.
تحقق من مكتبات فك الترميز وتوافق الإصدارات
سجّل إصدار المعرض، وصورة الحاوية، ومكتبة معالجة الصور، ووحدة فك ترميز HEIF، وبنية وحدة المعالجة المركزية، وما إذا كانت الإصدارات المخصصة للعتاد قد تغيرت أثناء التحديث. وقارنها بآخر عملية نشر معروفة بعملها.
تؤثر بعض أعطال HEIC في مجموعة فرعية من الصور فقط، حتى ضمن إصدار خادم واحد. وتذكر إحدى مشكلات Immich أن ملفات HEIC معينة فقط فشلت، ما يشير إلى حد متعلق بميزة في التنسيق، لا إلى غياب كامل لدعم HEIC.
اختبر الملف الأصلي نفسه باستخدام إصدار التطبيق السابق أو صورة عامل حالية معزولة. ولا تُجرِ الرجوع إلى إصدار أقدم إلا من نسخة احتياطية متسقة لقاعدة البيانات والإعدادات؛ لا تخفّض إصدار قاعدة بيانات الإنتاج عشوائيًا لاختبار وحدة فك ترميز الصور.
ميّز بين فشل معاينة الخادم ومشكلة تحميل الملف الأصلي من جهة العميل
افتح الأصل المتأثر في عميل الويب وتطبيق الهاتف وجلسة متصفح خاصة. وسجّل ما إذا كانت الصورة المصغرة في المخطط الزمني، والمعاينة المتوسطة، والصورة المشتقة بالحجم الكامل، وتنزيل الملف الأصلي تفشل بشكل مستقل.
قد يفشل المتصفح في عرض ملف HEIC الأصلي، بينما يفترض أن تعمل المعاينة المُنشأة. وتصف إحدى مشكلات Safari في Immich فشل تحميل ملف HEIC الأصلي، رغم أن العميل تمكن من استخدام معاينة أو صورة مشتقة بالحجم الكامل بديلة.
إذا فشل عميل واحد فقط، فامسح استجابة الأصل المخزنة مؤقتًا لدى ذلك العميل، وقارن إعدادات تحميل الملفات الأصلية. وإذا لم يعثر أي عميل على الصورة المصغرة وأظهر سجل العامل عدم إنشاء أي ملف، فأبقِ التشخيص في جانب الخادم.
أعد إنشاء الصور المشتقة المفقودة فقط بعد إصلاح السبب
انسخ قاعدة البيانات ووحدة تخزين البيانات الوصفية احتياطيًا، ثم شغّل مهمة الصور المصغرة المفقودة على مجموعة صغيرة متأثرة. وتأكد من أنها تنشئ صورًا مشتقة جديدة دون استبدال الملفات الأصلية.
وجّهت إصدارات Immich المستخدمين الذين لديهم صور مصغرة معطلة إلى تشغيل مهمة الصور المصغرة المفقودة بعد الإصلاحات ذات الصلة، ما يدعم إعادة الإنشاء المستهدفة بعد الإصلاح بدلًا من حذف مخزن الصور المصغرة بالكامل أولًا.
يوفر دليل ZimaSpace حول النسخ الاحتياطي الخاص لصور iPhone المتطلب المحيط بذلك: الاحتفاظ بالصور الأصلية والتحقق منها بشكل مستقل عن معاينات المعرض.
تُحل المشكلة عندما تظل بصمة الملف الأصلي دون تغيير، وينشئ العامل صورًا مصغرة لملف تعريف HEIC الفاشل، وتحمل جميع العملاء المدعومين الصورة المشتقة، وتتم معالجة صورة جديدة من الهاتف نفسه بنجاح دون إعادة بناء المكتبة بالكامل.
الدعم والنصائح
المزيد للقراءة

لماذا تؤدي استعادة وحدة تخزين Docker إلى إعادة إنشاء محتويات الملفات مع فقدان السمات الموسّعة؟
تشخيص لاستعادة وحدة تخزين يغطي جرد السمات الموسَّعة (xattr)، وخيارات tar وRsync، ومساحات الأسماء، ودعم الوجهة، والامتيازات، والتسميات، والبيانات الوصفية للتطبيق، والاختبارات.

لماذا يحتفظ الحاوي قيد التشغيل بحد الذاكرة القديم بعد تغيير ملف Compose؟
تشخيص لحدود الذاكرة يغطي مجموعات cgroups النشطة، وإعادة التشغيل مقابل إعادة الإنشاء، وحقول Compose، والحدود الصارمة والمرنة، والنطاقات الأصلية، وذاكرة التبديل، وأكوام الذاكرة في...

لماذا يؤدي إعادة تشغيل وكيل عكسي إلى إبطال كل جلسة في تطبيق مستضاف ذاتيًا واحد؟
تشخيص لفقدان الجلسة يشمل نطاق إعادة التشغيل، وملكية ملفات تعريف الارتباط، وتدوير الأسرار، والجلسات المدعومة بالتخزين المؤقت، والتوجيه الثابت، وبوابات المصادقة، والاسترداد.

