500 Internal Server Error

כשאתה רואה שגיאת 500 Internal Server Error, אתה עומד מול קיר. השרת אומר לך "משהו התקלקל אצלי"—וזהו. זו השגיאה המתסכלת ביותר לקבל כי היא לא מכילה שום מידע על מה שבעצם השתבש.

זה מכוון. ה-500 הוא שגיאה גורפת. כשהשרת נתקל במשהו לא צפוי—חריגה שלא טופלה, מסד נתונים שקרס, ערך null במקום שלא אמור להיות—ואין לו שגיאה ספציפית יותר להחזיר, הוא חוזר ל-500 כברירת מחדל. השגיאה שאתה רואה היא אף פעם לא השגיאה שקרתה.

מה השרת באמת אומר

תגובת 500 אומרת:

• השרת קיבל את הבקשה שלך
• הבקשה שלך נראתה תקינה
• משהו לא צפוי קרה במהלך העיבוד
• השרת לא יגיד לך מה

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
    "error": "Internal Server Error",
    "message": "An unexpected error occurred"
}

זה לא אומר לך כמעט כלום. וזה בכוונה. בסביבת ייצור, שרתים מסתירים את כשלונותיהם כי חשיפתם תהיה סיכון אבטחה. השגיאה האמיתית—מעקב המחסנית, פסק הזמן של מסד הנתונים, ערך null—חיה ביומנים, לא בתגובה.

מה באמת מתקלקל

חריגות שלא טופלו

הסיבה הנפוצה ביותר. קוד זורק שגיאה שאף אחד לא תופס:

app.get('/api/users/:id', async function(request, response) {
    // אם זה זורק שגיאה, אין catch—ישר ל-500
    const user = await database.findUser(request.params.id);
    response.json(user);
});

כשלי מסד נתונים

מסד הנתונים לא זמין, מאגר החיבורים מוצה, או השאילתה לא תקינה:

// חיבור נדחה, פסק זמן לשאילתה, שגיאת תחביר—הכל הופך ל-500
const data = await database.query('SELECT * FROM users');

טעויות תצורה

משתנה סביבה חסר, כתובת URL לשירות שמוגדרת בצורה שגויה:

const apiKey = process.env.API_KEY; // undefined
await externalService.fetch(apiKey); // נכשל בצורה מסתורית

מיצוי משאבים

השרת נגמרה לו הזיכרון, שטח הדיסק, או חיבורי מסד הנתונים. אלה הכי קשים לנפות באגים כי הם לא תמיד משאירים מעקבי מחסנית נקיים.

הפניה ל-Null

הקלאסיקה:

const user = getUser(id);
response.json({ name: user.name.toUpperCase() }); // user הוא null

שני הפנים של תגובות השגיאה

שגיאת 500 צריכה להראות פנים שונות בהתאם למי שמסתכל.

בסביבת ייצור (מה שמשתמשים רואים):

{
    "error": "Internal Server Error",
    "message": "An unexpected error occurred",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

בסביבת פיתוח (מה שאתה רואה):

{
    "error": "TypeError",
    "message": "Cannot read property 'name' of null",
    "stack": "TypeError: Cannot read property 'name' of null\n    at /app/routes/users.js:15:32",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

מזהה הבקשה הוא קריטי. הוא הגשר בין השגיאה חסרת התועלת שהמשתמש רואה לבין השגיאה האמיתית ביומנים שלך. כשמשתמש מדווח "קיבלתי שגיאה", המזהה הזה מאפשר לך למצוא בדיוק מה קרה.

לתפוס את מה שנופל

המטרה פשוטה: שום דבר לא אמור להגיע לשגיאת 500 שלא טופלה.

// עטוף מסלולים בודדים
app.get('/api/data', async function(request, response) {
    try {
        const data = await fetchData();
        response.json(data);
    }
    catch(error) {
        logger.error('נכשל בשליפת נתונים', { error, requestId: request.id });
        response.status(500).json({
            error: 'נכשל בשליפת נתונים',
            requestId: request.id
        });
    }
});

// מטפל גלובלי תופס את כל השאר
app.use(function(error, request, response, next) {
    logger.error({
        requestId: request.id,
        url: request.url,
        method: request.method,
        error: error.message,
        stack: error.stack
    });

    response.status(500).json({
        error: 'Internal Server Error',
        requestId: request.id
    });
});

מה לקוחות צריכים לעשות

שגיאת 500 עשויה להיות זמנית—תקלה רגעית במסד הנתונים, עלייה קצרה בעומס. נסה שוב עם השהייה הולכת וגדלה:

async function fetchWithRetry(url, maxRetries = 3) {
    for(let attempt = 0; attempt < maxRetries; attempt++) {
        const response = await fetch(url);

        if(response.status >= 500 && attempt < maxRetries - 1) {
            // המתן יותר כל פעם: שנייה אחת, שתיים, ארבע
            await sleep(Math.pow(2, attempt) * 1000);
            continue;
        }

        return response;
    }
}

ותראה למשתמשים משהו אנושי:

if(response.status === 500) {
    const error = await response.json();
    showError(
        'משהו השתבש אצלנו. אנא נסה שוב.',
        `מספר פנייה: ${error.requestId}`
    );
}

מציאת השגיאה האמיתית

ה-500 הוא תסמין. המחלה נמצאת ביומנים שלך.

# מצא את הבקשה
grep "550e8400-e29b-41d4-a716" /var/log/app.log

# מצא שגיאות אחרונות
grep -A 20 "Error:" /var/log/app.log | tail -100

חפש דפוסים:

• מבוסס זמן: שגיאות במהלך גיבויים, בשעות עומס שיא, בחצות כשעבודות cron רצות
• ספציפי למסלול: מסלול אחד שנכשל יותר מאחרים
• ספציפי למשתמש: חשבונות או נתונים מסוימים שמפעילים כשלים

שירותי מעקב שגיאות (Sentry, Rollbar, Bugsnag) מקלים על זה—הם אוספים ומסדרים שגיאות, מציגים מעקבי מחסנית, עוקבים אחר תדירות, ומתריעים על עליות חדות.

שגיאות 5xx אחרות

השתמש ב-500 רק כשאין שום דבר ספציפי יותר שמתאים:

• 502 Bad Gateway: השרת שלך פנה לשרת אחר וקיבל ממנו תגובה פסולה
• 503 Service Unavailable: השרת עמוס זמנית או מושבת לתחזוקה
• 504 Gateway Timeout: השרת שלך פנה לשרת אחר ולא קיבל תשובה כלל

אלה נותנים ללקוחות מידע טוב יותר. שגיאת 503 עם כותרת Retry-After אומרת להם מתי לחזור. שגיאת 502 אומרת להם שהבעיה נמצאת בשרשרת, לא כאן.

הטעויות שכואבות

חשיפת פרטים פנימיים:

// מסוכן—חושף את סכמת מסד הנתונים
{"error": "SequelizeDatabaseError: column 'api_key' does not exist"}

בליעת שגיאות:

catch(error) {
    // השגיאה נעלמת לתוך החלל—בהצלחה עם ניפוי באגים
    response.status(500).json({ error: 'Error' });
}

שימוש ב-500 לטעויות של לקוחות:

// שגוי: הלקוח שלח נתונים שגויים, זה 400
POST /api/users {"email": "not-an-email"}
HTTP/1.1 500 Internal Server Error

ה-500 הוא למקרים שבהם אתה שברת משהו. ה-400 הם למקרים שבהם הם עשו את זה.

שאלות נפוצות על שגיאות 500 Internal Server Error

למה שגיאת 500 לא אומרת לי מה השתבש?

אבטחה. הודעת שגיאה מפורטת עשויה לחשוף את מבנה מסד הנתונים שלך, נתיבי קבצים, או הספריות שבהן אתה משתמש—מידע שתוקפים יכולים לנצל. השגיאה האמיתית הולכת ליומנים שלך, שרק אתה יכול לראות.

האם כדאי לנסות שוב שגיאת 500?

כן, עם מגבלות. חלק מהשגיאות 500 הן זמניות (תקלה קצרה במסד הנתונים), חלקן קבועות (באג בקוד שלך). נסה שוב פעמיים או שלוש עם השהיות הולכות וגדלות. אם ממשיך להיכשל, עצור—כנראה שניסיון נוסף לא יתקן באג בקוד.

איך מנפים באגים בשגיאת 500 בסביבת ייצור?

התחל עם מזהה הבקשה. כל תגובת 500 צריכה לכלול אחד. חפש ביומנים שלך את המזהה הזה כדי למצוא את מעקב המחסנית האמיתי. אם עדיין אין לך מזהי בקשות, הוסף אותם—הם הכלי השימושי ביותר לניפוי באגים בסביבת ייצור.

מה ההבדל בין 500 לבין 502?

500 אומר שהשרת שלך נשבר. 502 אומר שהשרת שלך תקין, אבל משהו שהוא תלוי בו (מסד נתונים, API, שירות חיצוני) החזיר תגובה פסולה. ההבחנה עוזרת לצמצם היכן לחפש.