فشل تحميل النموذج: غير موجود، غير معروف، أو بنية غير متوافقة
تنقسم حالات فشل تحميل النموذج في ComfyUI عادةً إلى ثلاث فئات: عدم العثور على الملف، عدم التعرف على الملف، وعدم توافق البنية. تختلف اتجاهات تشخيص هذه الفئات الثلاث تمامًا، لذا حدّد أولاً الفئة التي تنتمي إليها، ثم اتبع الخطوات الثلاث أدناه، ولا تبدأ بإعادة التنزيل مباشرة. قبل البدء، يُنصح بالاطلاع على الفحص السريع خلال 60 ثانية في نظرة عامة على استكشاف الأخطاء.
الأعراض
قارن المظاهر الثلاثة أدناه لتحديد نوع مشكلتك:
- قائمة النماذج المنسدلة في العُقدة فارغة، أو لا ترى النموذج الذي وضعته للتو — غالبًا ما تكون مشكلة في المسار.
- يظهر خطأ
Value not in list: ckpt_name: 'model-name.safetensors' not in []أثناء التشغيل (لم يتم العثور على النموذج المحدد) — الملف ليس في مسار البحث. - يظهر خطأ أثناء التوليد يتعلق بعدم تطابق أبعاد tensor أو shape — عدم توافق البنية.
فحص سريع (60 ثانية)
- هل الملف موجود في الدليل الفرعي المناسب للنوع تحت
ComfyUI/models/؟ ضع checkpoint فيcheckpoints/، وLoRA فيloras/، وVAE فيvae/. - هل الامتداد موجود في قائمة الصيغ المدعومة في ComfyUI (الأكثر شيوعًا
.safetensors/.ckpt)؟ وهل حجم الملف يطابق ما هو مذكور في صفحة الإصدار الرسمية؟ - اضغط مرة واحدة على زر التحديث (Refresh) في الواجهة أو أعد تشغيل ComfyUI، ثم تحقق من القائمة المنسدلة.
خطوات التشخيص
الخطوة 1 : تأكيد مسار البحث
الخطأ: Value not in list: ckpt_name: 'model-name.safetensors' not in [] (لم يتم العثور على النموذج المحدد)
الحل: ضع النموذج في الدليل الفرعي المناسب للنوع، أو اجعل ComfyUI يقرأ دليلك المخصص. وضع الملف في دليل نوع خاطئ هو السبب الأكثر شيوعًا — إذا وُضع checkpoint في loras/، فلن يظهر في القائمة المنسدلة بطبيعة الحال. إذا وضعت نماذجك في قرص آخر، يجب تسجيل مسار بحث إضافي في extra_model_paths.yaml (للاطلاع على طريقة كتابة الإعداد، راجع أين تضع النماذج: شرح دليل models و extra_model_paths)، وبعد التعديل أعد تشغيل ComfyUI ليصبح ساريًا.
الخطوة 2 : تأكيد سلامة الملف وصحة صيغته
الخطأ: Error while deserializing header (لا يمكن التعرف على ملف النموذج / نتيجة التحميل فارغة)
الحل: اشك في الملف نفسه أولاً، وأعد تنزيله وتحقق من حجمه. انقطاع التنزيل قد يترك ملفًا تالفًا؛ تأكد من أن الامتداد موجود في قائمة الصيغ المدعومة في ComfyUI (.safetensors، .ckpt، .pt، .pth، .bin وغيرها، والقائمة الكاملة في أين تضع النماذج)؛ إذا كان اسم الملف يحتوي على أحرف خاصة أو صينية، غيّره إلى أحرف إنجليزية وأرقام فقط ثم حدّث القائمة @@I18N_KEEP_000014@@.
الخطوة 3 : معالجة عدم توافق البنية
الخطأ: The size of tensor a (49) must match the size of tensor b (16) at non-singleton dimension 1 (عدم تطابق أبعاد tensor / shape)
الحل: يشير هذا النوع من الأخطاء إلى عدم تطابق بنية النموذج مع المُحمِّل، وليس إلى تلف الملف. هناك ثلاث حالات شائعة: استخدام مُحمِّل checkpoint عام لتحميل نموذج يحتوي على أوزان جزئية فقط، ويجب بدلاً من ذلك استخدام عُقدة التحميل المخصصة المقابلة (راجع جدول المقارنة لعُقد loader المقابلة لكل نوع نموذج في أين تضع النماذج)؛ عدم توافق بنية LoRA مع النموذج الأساسي، فبدّل إلى LoRA من نفس البنية؛ النموذج حديث جدًا، وقد لا يدعم إصدار ComfyUI الحالي بنيته بعد، فحدّث إلى أحدث إصدار وحاول مجددًا. كما أن اختيار VAE خاطئ يسبب خطأ عدم تطابق عدد القنوات، مثل استخدام sdxl_vae.safetensors مع نموذج Flux، والحل هو استبداله بـ ae.safetensors من إصدار Flux الرسمي. تحقق أولاً من البنية المذكورة في صفحة إصدار النموذج، ثم اختر المُحمِّل المطابق.
شروط تصعيد المشكلة
عند حدوث أي من الحالات التالية، لا تستمر في المحاولة محليًا، بل افتح issue في مستودع GitHub الخاص بـ ComfyUI :
- بعد تغيير المُحمِّل والدليل الصحيحين، لا يزال خطأ أبعاد tensor يظهر.
- نفس ملف النموذج يُحمَّل بشكل طبيعي في أدوات أخرى، و ComfyUI وحده يُظهر الخطأ.
- المشكلة مستمرة بعد إعادة التنزيل، ويُشتبه في وجود خلل في ملف النموذج نفسه.
عند فتح issue، أرفق ما يلي: نص الخطأ الكامل، واسم النموذج ومصدر تنزيله، وإصدار ComfyUI لديك وطريقة تشغيله.