إصدار API “5.4.296” لا يطابق إصدار Worker “5.3.31”…أتلقى هذا الخطأ,لقد حاولت على كل من المضيف الذاتي والسحابة
مرحباً بالفريق، أتلقى الخطأ أعلاه
وصف المشكلة/الخطأ/السؤال
إصدار API “5.4.296” لا يطابق إصدار Worker “5.3.31”…أتلقى هذا الخطأ,لقد حاولت على كل من المضيف الذاتي والسحابة
ما هي رسالة الخطأ (إن وجدت)؟
إصدار API “5.4.296” لا يطابق إصدار Worker “5.3.31”…أتلقى هذا الخطأ,لقد حاولت على كل من المضيف الذاتي والسحابة
يرجى مشاركة سير العمل الخاص بك
(حدد العقد على لوحتك واستخدم اختصارات لوحة المفاتيح CMD+C/CTRL+C و CMD+V/CTRL+V لنسخ ولصق سير العمل.)
شارك الإخراج الذي أرجعته العقدة الأخيرة
{
“errorMessage”: “إصدار API "5.4.296" لا يطابق إصدار Worker "5.3.31".”,
“errorDescription”: “إصدار API "5.4.296" لا يطابق إصدار Worker "5.3.31".”,
“errorDetails”: {},
“n8nDetails”: {
“time”: “6/8/2026, 9:14:28 PM”,
“n8nVersion”: “2.23.2 (Self Hosted)”,
“binaryDataMode”: “filesystem”
}
}
معلومات حول إعداد n8n الخاص بك
- إصدار n8n: الأحدث
- قاعدة البيانات (الافتراضي: SQLite): pinecoine
- إعداد n8n EXECUTIONS_PROCESS (الافتراضي: own, main): own
- تشغيل n8n عبر (Docker, npm, n8n cloud, desktop app): docker
- نظام التشغيل: Windows 11
مرحباً @Sameer_Kalkeri
أولاً، من المهم معرفة أن هذا الخطأ ليس في الواقع مشكلة في تثبيت n8n الكلي أو خادمك. بدلاً من ذلك، إنه تضارب يحدث داخل “أداة صغيرة” محددة يستخدمها n8n لقراءة ومعالجة ملفات PDF. هذه الأداة تعمل مثل مترجم يساعد n8n على فهم محتويات مستند PDF.
تحدث المشكلة لأن جزأين مختلفين من نظامك يستخدمان إصدارات مختلفة من أداة PDF هذه. عادةً، يحتوي n8n على إصدار مدمج خاص به، لكن إذا قمت بتثبيت “عقدة مجتمعية” (مثل Tesseract للتعرف الضوئي على الأحرف)، فإن هذا الإضافة غالباً ما تأتي بإصدار أحدث خاص بها. عندما يحاول n8n معالجة ملف، يتصادم هذان الإصداران، ويصبح النظام في حالة ارتباك.
المصطلحات التقنية “إصدار API” و"إصدار Worker" تشير بشكل أساسي إلى مدير وعامل. تخيل مديراً يعطي تعليمات بلغة واحدة (الإصدار 5.4) لكن العامل يفهم فقط لغة أقدم قليلاً (الإصدار 5.3). لأنهم لا يتحدثان نفس الإصدار من اللغة بالضبط، لا يمكنهم التواصل، والعملية تتعطل.
لإصلاح هذا، الحل الأسهل هو البحث عن أي عقد مثبتة من المجتمع تتعلق بـ PDF أو التعرف الضوئي على الأحرف، خاصةً عقدة Tesseract. إذا كان لديك Tesseract مثبتاً، حاول الرجوع إلى الإصدار 1.3.0. هذا الإصدار الأقدم لا يستخدم أداة PDF المتضاربة، مما يزيل التضارب ويسمح لسير عملك بالعمل بسلاسة مرة أخرى.
في حالتك المحددة، بما أنك تقوم بتنزيل الملفات من Google Drive وإرسالها إلى Vector Store، فمن المحتمل أنك تعالج ملفات PDF. لأن هذا التضارب يحدث عالمياً عبر مثيل n8n الخاص بك، حتى إذا لم تكن تستخدم عقدة Tesseract في سير العمل المحدد هذا، فإن وجودها مثبتة في أي مكان على حسابك يمكن أن يؤدي إلى حدوث هذا الخطأ.
هل ساعدك هذا؟
مرحبا @Sameer_Kalkeri
وفقاً لـ GitHub، تم حل هذا الخطأ في الإصدار 2.23.4، ما هو إصدارك الحالي؟
بعد تأكيد الإصدار المستقر، لا تستخدم النسخة التجريبية، قم بإلغاء النشر، وعطّل العُقد، ثم فعّلها مرة أخرى وانشر. يرجى إعادة الإجابة لنا من فضلك.
لا أملك أي tesseract مثبت.. وحاولت على كل من الخادم السحابي والمثيل ذاتي الاستضافة
لقد فعلت ذلك بالفعل، لقد حاولت على كلا من الخادم الخاص والسحابة وما زلت أحصل على نفس الخطأ
رائع @Sameer_Kalkeri
يرجى مشاركة سير العمل الخاص بك، انسخ والصقه هنا بدون البيانات الحساسة.
@Sameer_Kalkeri
من فضلك انقر على كل عقدة بها الرمز الأحمر وأرسل صورة لكل واحدة
@Sameer_Kalkeri
شكراً لمشاركتك!
حدّث جميع الخدمات إلى نفس الصورة، أعد تشغيل جميع حاويات Docker
docker compose pull
docker compose up -d
، وتحقق من أن جميعها من نفس الإصدار
docker compose ps
docker exec -it <container_n8n> n8n --version
docker exec -it <container_worker> n8n --version
وثائق عقدة Default Data Loader | n8n Docs
أخبرنا إذا نجح الأمر.
شكراً لك، أعدت تشغيله… نجح الآن.. لكنني أحصل على خطأ dommatrix.
@Sameer_Kalkeri هذا عطل في المكتبة التي تقرأ ملفات PDF في بيئة Node.js/self-hosted.
@Sameer_Kalkeri
استخدم إصدار 1.100.1 من n8n
لماذا يجب أن أقوم بتقليل إصداره؟
سيؤثر على سير عملي الآخر
هذا الخطأ ناتج عن عدم توافق الإصدارات بين مكونات n8n الخاصة بك في وضع الرتل، حيث يعمل العملية الرئيسية على الإصدار 5.4.296 بينما يعمل أحد العمال على الإصدار 5.3.31. في وضع الرتل، يجب أن تعمل النسخة الرئيسية والعمال وأي معالجات للخطافات على نفس إصدار n8n بالضبط، ولم يتم ترقية أحدها مع البقية.
الحل: اجعل كل حاوية تشغل نفس علامة الصورة. إذا حددت إصدارًا معينًا في ملف التكوين الخاص بك، قم بترقية جميعها معًا (الرئيسية والعمال) وأعد الإنشاء، أو إذا كنت تستخدم :latest، فالسبب الشائع هو أن حاوية واحدة سحبت صورة أحدث من الأخرى، لذا قم بتشغيل docker compose pull ثم docker compose up -d --force-recreate عبر المكدس بأكمله حتى تصل جميعها إلى نفس الإصدار. بعد إعادة التشغيل، تحقق من أن كليهما يبلغ عن نفس الإصدار.
ما يجب تجنبه في المستقبل: حدد علامة إصدار صريحة على جميع المكونات بدلاً من :latest، بحيث لا يمكن لسحب جزئي أن يترك عمالك متأخرًا عن الإصدار الخاص بعمليتك الرئيسية. قد تسبب عدم التطابق مثل هذا سلوكًا غير متسق أو فشلًا محيرًا في التنفيذ، لذا من الجدير بالأمر قفل جميعها على نفس الإصدار. هل أنت تستخدم Docker Compose، وهل قمت بترقية جزء من المكدس مؤخرًا فقط؟
مرحبا @Sameer_Kalkeri،
أهلا بك في المجتمع!
تبدو هذه المشكلة مشابهة لـ نقاش سابق.
انحدار معروف منذ الإصدار n8n 1.98 عندما تم ترقية pdfjs-dist إلى نسخة تتطلب واجهات برمجية للمتصفح مثل DOMMatrix — هناك عدة مشاكل مفتوحة على GitHub بشأنها (#16593, #16438, #16422).
الحل البديل: تجاوز Document Loader للملفات بصيغة PDF واستخدم عقدة Code مع حزمة npm pdf-parse بدلاً من ذلك. عيّن NODE_FUNCTION_ALLOW_EXTERNAL=pdf-parse في متغيرات البيئة الخاصة بك، واستخرج النص في عقدة Code، ثم مرر النص المستخرج مباشرة إلى Vector Store Insert.
سيكون رائعاً إذا كان بإمكانك مشاركة ملف JSON لسير العمل الخاص بك لتأكيد ما إذا كنت تواجه نفس المشكلة.
مرحباً بك في مجتمع n8n @Sameer_Kalkeri
حدّث نسختك إلى الإصدار 2.23، وتأكد من أن إصدار Node.js هو الأحدث، وإذا لم ينجح شيء فكر في استخدام عقدة مخصصة لاستخراج النص من ملفات PDF (مثل PDF to Text) أو عقدة برمجية باستخدام مكتبات مثل pdf-parse أو pdfjs-dist، التي لا تعتمد على واجهات برمجة تطبيقات المتصفح للعمل.
أنا مبتدئ، هل يمكنك من فضلك أن تساعدني خطوة بخطوة…هذه المصطلحات تقنية جداً
@Sameer_Kalkeri
كمبتدئ، يُنصح بإجراء الدورتين 1 و2 من المجتمع بالإضافة إلى فهم التوثيق التالي لدعمك،
تحديث المثيل n8n Hosting Documentation and Guides | n8n Docs
استبدال قارئ PDF القديم Extract From File | n8n Docs
مثال لاستخراج النصوص من ملف PDF الرسمي Extract text from a PDF file | n8n workflow template
إذا كنت ستستخدم عقدة الكود Code node documentation | n8n Docs
تفعيل الوحدات الخارجية Enable modules in Code node | n8n Docs
إن أمكن، شارك ملف JSON الخاص بك بدون البيانات الحساسة لنتمكن من فهم حالتك بشكل أفضل.
