Stack Traceأثر الانهيار

آلة في المصنع توقّفت فجأة، وتدلّى من جانبها شريط ورقيّ طويل ملتفّ على الأرض. يفزع من لا يعرف ويبتعد. أمّا الفنّيّ فيلتقط الشريط ويلفّه ببطء ويقرأ: هذه آخر خطوة قبل التوقّف، وقبلها هذه، وقبلها تلك. الشريط لا يصرخ ولا يلوم؛ يروي بالترتيب ما كانت الآلة تفعله لحظة انهيارها.

حين يصطدم البرنامج بشيء لا يحتمله يتوقّف ويطبع أثر الانهيار (Stack Trace): قائمة بالخطوات التي كان في وسطها لحظة الفشل، خطوة فوق خطوة. البرنامج يستدعي دالّة، تستدعي دالّة أخرى، تستدعي ثالثة، كأنّها أطباق مرصوصة في مكدّس (Stack). وحين تفشل الأعمق منها، يُطبع المكدّس كلّه.

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

الشريط الملتفّ هو جدار النصّ، ولفّه هو القراءة من الأعلى، والفنّيّ هو المطوّر أو الوكيل الذي تسلّمه إيّاه.

وتفريق ضروريّ: التتبّع (Trace) يتابع طلبًا واحدًا بين خدمات كثيرة كالطرد بين المستودعات. أمّا أثر الانهيار فتكبير معكوس: تشريح برنامج واحد في لحظة سقوطه. ذاك خريطة الرحلة، وهذا شريط الآلة.

لعلّ هذا أكثر مدخل عمليّ في الكتاب لك. ستلصق هذا النصّ في محادثاتك مع النموذج مرارًا، والفرق بين من يخرج من الورطة في دقائق ومن يتخبّط ساعة هو هذا: الصق الأثر كاملًا، لا «توقّف عن العمل». النصّ الكامل يعطي النموذج الملفّ والسطر والخطأ بالضبط، وكثيرًا ما يكون خطأ نوع (Type / Type Error). أمّا «لا يعمل» فتجبره على التخمين، والتخمين موطن الهلوسة (Hallucination).

موقف من حياتك: يتعطّل تطبيق الحجز في عيادتك، فترسل للوكيل «الصفحة توقّفت» فيسألك عشرة أسئلة. وفي المرّة التالية ترسل الجدار الأحمر كاملًا كما ظهر، فيردّ في رسالة واحدة: «السطر 42 في ملفّ المواعيد يطلب حقلًا غير موجود، أصلحته».