Lorixen.
AR

استيراد قاعدة البيانات يتوقف: حل خطأ max_allowed_packet

باختصار: عندما تنقل قاعدة بيانات متجرك أو موقعك إلى خادم جديد ويتوقف الاستيراد برسالة «Got a packet bigger than 'max_allowed_packet' bytes»، فالمعنى أن سطراً واحداً في ملف النسخة أكبر من الحد الذي يقبله الخادم أو برنامج الاستيراد في رسالة واحدة. القيمة الافتراضية في MariaDB هي 16 ميغابايت، والحد الأعلى 1 غيغابايت. الحل: ارفع الحد على الخادم وعلى أداة الاستيراد معاً، أو أنشئ النسخة من جديد بأسطر INSERT أصغر، ثم تأكد أن الجداول اكتملت فعلاً.

متى تظهر هذه المشكلة

متجر إلكتروني في عمّان ينتقل من استضافة مشتركة إلى خادم خاص، أو مدرسة خاصة تنقل نظام تسجيلها إلى مزود آخر، أو شركة تطوير تنقل موقع زبون إلى بيئة تجريبية. الخطوة نفسها في كل الحالات: ملف ‎.sql‎ من الخادم القديم، ثم استيراده في الجديد. الملف كان يعمل في مكانه الأصلي، لكن الاستيراد يتوقف في منتصفه.

الرسالة الأكثر شيوعاً هي الخطأ رقم 1153، واسمه في مرجع أخطاء MariaDB هو ER_NET_PACKET_TOO_LARGE، ونصه «Got a packet bigger than 'max_allowed_packet' bytes». وأحياناً يظهر بدلاً منه انقطاع عام في الاتصال بالخادم أثناء الاستيراد، وهي رسالة أقل وضوحاً لكن سببها قد يكون الحد نفسه.

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

ما معنى max_allowed_packet

يعرّف توثيق MariaDB هذا المتغير بأنه الحجم الأقصى بالبايت لحزمة واحدة أو لنص مُنشأ أو وسيط. ويبدأ مخزن الرسائل بحجم net_buffer_length، ثم يمكن أن يكبر حتى max_allowed_packet. التوثيق ينصح بأن يكون الحد بحجم أكبر قيمة BLOB لديك على الأقل، وبمضاعفات 1024، ويقول صراحة إنه إذا غيّرت القيمة فيجب تغييرها على جهة العميل أيضاً.

لماذا يحدث هذا مع ملفات النسخ تحديداً؟ أدوات النسخ تجمع عادة صفوفاً كثيرة في أمر INSERT واحد لتسريع الاستيراد. يوضح توثيق mariadb-dump أنه عند إنشاء أوامر INSERT متعددة الصفوف، باستخدام الخيار ‎--extended-insert‎ أو ‎--opt‎، تُبنى الأسطر حتى طول net_buffer_length. فإذا كانت النسخة أُنشئت على خادم بإعدادات أكبر، أو كان في الجدول صف ضخم بمفرده، يصبح أمر واحد أكبر من الحد على الخادم الجديد.

ما الذي يجعل صفاً واحداً ضخماً

في مواقع الأعمال الصغيرة، المصادر المعتادة للصفوف الكبيرة هي:

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

معرفة السبب تفيدك لاحقاً، لكنها ليست شرطاً لإكمال الاستيراد الآن.

لماذا عمل الملف على الخادم القديم

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

الحل الأول: ارفع الحد على الخادم

إذا كنت تملك الخادم، ارفع القيمة في ملف إعدادات قاعدة البيانات تحت قسم الخادم، مثلاً:

[mysqld]
max_allowed_packet = 64M

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

لا تقفز مباشرة إلى 1 غيغابايت. ابدأ بقيمة معقولة مثل 64 أو 128 ميغابايت، وارفعها فقط إذا تكرر الخطأ.

الحل الثاني: ارفع الحد على أداة الاستيراد

هذا الجزء ينساه كثيرون. حتى لو رفعت الحد على الخادم، فبرنامج سطر الأوامر الذي يقرأ الملف له حده الخاص. يذكر توثيق برنامج mariadb أن الخيار ‎--max-allowed-packet‎ يحدد الطول الأقصى للحزمة المرسلة أو المستقبلة، وأن القيمة الافتراضية 16 ميغابايت والحد الأعلى 1 غيغابايت.

mariadb --max-allowed-packet=64M -u shop_user -p shop_db < backup.sql

ولأداة النسخ mariadb-dump خيار بالاسم نفسه، تحتاجه إذا كنت تنشئ نسخة جديدة من خادم فيه صفوف كبيرة.

الحل الثالث: نسخة بأسطر أصغر

إذا كنت على استضافة مشتركة لا تسمح لك بتعديل إعدادات الخادم، فالحل من الجهة الأخرى: أنشئ النسخة من جديد على الخادم القديم بأوامر INSERT أصغر. الخيار ‎--net-buffer-length‎ في mariadb-dump يحدد حجم المخزن الأولي، ويوضح التوثيق أنه يمكن استخدامه لتقييد حجم الصفوف في ملف النسخة عند الأوامر متعددة الصفوف. هذا لا يحل مشكلة صف واحد أكبر من الحد بمفرده، لكنه يحل الحالة الأكثر شيوعاً، وهي أوامر تجمع صفوفاً كثيرة.

وإذا كانت المشكلة في صف واحد ضخم فعلاً، فلا بد من رفع الحد في مكان ما، أو نقل ذلك المحتوى خارج قاعدة البيانات أولاً.

تأكد أن الاستيراد اكتمل

بعد نجاح الاستيراد دون أخطاء، لا تكتفِ بأن الموقع يفتح:

  1. قارن عدد الجداول بين الخادم القديم والجديد.
  2. قارن عدد الصفوف في الجداول المهمة: الطلبات، المنتجات، الزبائن، المستخدمين.
  3. افتح آخر طلب أو آخر تسجيل في لوحة التحكم وتأكد أنه موجود.
  4. احتفظ بسجل أوامر الاستيراد، حتى تعرف إن ظهر خطأ في منتصفه وأنت لا تنظر.

مثال توضيحي: متجر ينتقل إلى خادم خاص

هذا مثال توضيحي لطريقة المعالجة، وليس حالة حقيقية. متجر أدوات منزلية ينقل موقعه إلى خادم خاص. يتوقف الاستيراد عند جدول المحتوى بالخطأ 1153. يرفع المسؤول max_allowed_packet على الخادم الجديد إلى 64 ميغابايت ويعيد تشغيل الخدمة، لكن الخطأ يتكرر، لأن أمر الاستيراد ما زال بالحد الافتراضي. يضيف ‎--max-allowed-packet=64M‎ إلى أمر الاستيراد، فيكتمل. ثم يقارن عدد الطلبات والمنتجات مع الخادم القديم قبل تحويل النطاق، ويجد صفحة قديمة فيها صور مضمنة كنص، فيحولها لاحقاً إلى ملفات عادية.

أسئلة شائعة

شو يعني خطأ packet bigger than max_allowed_packet؟

يعني أن أمراً واحداً في ملف النسخة أكبر من الحد الذي يقبله الخادم أو أداة الاستيراد في رسالة واحدة.

رفعت القيمة بالسيرفر وما زال الخطأ، ليش؟

غالباً لأن أداة الاستيراد نفسها ما زالت على حدها الافتراضي. ارفع الخيار في أمر الاستيراد أيضاً، وافتح جلسة جديدة.

أنا على استضافة مشتركة، شو بعمل؟

أنشئ النسخة من جديد بأسطر أصغر عبر ‎--net-buffer-length‎، أو اطلب من مزود الاستضافة رفع الحد.

كيف بعرف إنو الاستيراد كمل صح؟

قارن عدد الجداول والصفوف المهمة بين الخادمين، وافتح آخر طلب أو تسجيل قبل تحويل النطاق.

إذا توقف استيراد قاعدة بيانات موقعك في منتصفه أثناء نقل الاستضافة، راسلنا ونكمل النقل ونقارن البيانات قبل أن يصل إليها زبائنك.

المصادر

WhatsAppاحجز مكالمة