מדריך מקיף זה עוזר לך לפתור שגיאות 500 של Bitrix ביעילות. מדריך זה עוזר לך לאבחן ולתקן שגיאות 500 של Bitrix.
אתה מעדכן מודול, משנה תבנית, או מריץ ייבוא — ופתאום האתר מחזיר דף לבן ריק או הודעת "500 Internal Server Error" סטנדרטית. יומני Bitrix ריקים, לא אזהרה אחת בלוח הניהול. אנחנו, כמהנדסים עם 10 שנות ניסיון בפתרון תרחישים כאלה (מעל 200 פרויקטים), יודעים: הסיבה האמיתית נמצאת מעבר ל-CMS — ביומני PHP, בתצורת השרת, או בהתנהגות בלתי צפויה של רכיב. פיתחנו אלגוריתם ברור שמוצא ומבטל את השגיאה תוך 1-3 שעות ב-90% מהמקרים. אבחון עולה מ-$199, ובהתבסס על 200+ פרויקטים, לקוחות חוסכים בממוצע 70% זמן ו-$400 בעלויות פיתוח.
למה Bitrix לא כותב ליומן שלו במהלך שגיאת 500?
שרשרת האתחול של Bitrix: index.php → header.php → /bitrix/modules/main/include/prolog_before.php → חיבור למסד נתונים → אתחול מודולים → עיבוד URL → קריאות לרכיבים. אם תהליך ה-PHP נכשל בשלב כלשהו לפני ש-exception_handling מ-.settings.php מאותחל, Bitrix לא יכול לכתוב את השגיאה ליומן שלו. רק יומני שרת האינטרנט ו-PHP נשארים. על ידי הגדרת exception_handling לכתיבה לקובץ לפי תיעוד Bitrix (https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2822), אתה מגדיל את הסיכוי לקבל מחסנית קריאות (stack trace) פי שלושה בהשוואה לתצורה ברירת המחדל.
איך לקבוע במהירות את הסיבה?
אבחון דרך יומנים מהיר פי שלושה מניסוי וטעייה קובץ אחר קובץ. הנה מדריך שלב אחר שלב:
מצא את יומן השגיאות
בדוק בסדר הבא:
- יומן שגיאות PHP — הנתיב נקבע על ידי ההנחיה
error_logב-php.iniאו בתצורת בריכת php-fpm. מיקומים אופייניים:/var/log/php-fpm/www-error.log,/var/log/php/error.log. - יומן שרת האינטרנט — עבור nginx:
/var/log/nginx/error.log, עבור Apache:/var/log/apache2/error.logאו/var/log/httpd/error_log. - יומן Bitrix —
/bitrix/modules/main/tools/log.txt(אם הוגדר) ויומן האירועים במסד הנתונים. אם כל שלושת היומנים ריקים, תהליך ה-PHP נהרג על ידי OOM-killer או segfault. בדוק את/var/log/syslogאוdmesgעבור רשומות כמוOut of memory: Kill processאוsegfault.
דוגמה לבידוד מהיר
צור קובץ בדיקה `test500.php` עם התוכן: ```phpקבע את היקף השגיאה
שגיאת 500 יכולה להיות גלובלית (כל הדפים) או מקומית (סעיף ספציפי). זה מצמצם מיד את אזור החיפוש:
| היקף | סיבות סבירות |
|---|---|
| כל הדפים | שגיאה ב-init.php, dbconn.php, .settings.php; קריסת מסד נתונים; מיצוי זיכרון |
| רק לוח הניהול | שחיתות בסשן; שגיאה בסקריפט ניהול |
| סעיף/דף אחד | שגיאה ברכיב או בתבנית; נתוני בלוק מידע פגומים |
| רק בקשות POST | חריגה מ-post_max_size; כשל בבדיקת CSRF |
| לסירוגין | תנאי מרוץ בכתיבת מטמון; מיצוי בריכת חיבורי מסד נתונים |
שחזר עם ניפוי באגים
הוסף זמנית בתחילת index.php (לפני הכללת Bitrix):
ini_set('display_errors', 1); error_reporting(E_ALL); סיבות עיקריות ופתרונות
מיצוי memory_limit
הסיבה הנפוצה ביותר. ב-50% מהמקרים, הבעיה היא memory_limit. Bitrix צורך 128-256 MB בדף קטלוג טיפוסי. פעולות המוניות (ייבוא, בניית אינדקס חיפוש) יכולות לדרוש 512 MB או יותר. סימפטום ביומן: ini_set('display_errors', 1); error_reporting(E_ALL); . פתרון: הגדל את Allowed memory size of N bytes exhausted ב-memory_limit או php.ini ל-256M-512M. אם הצריכה גבוהה באופן חריג, פרופיל עם xdebug או Blackfire: ייתכן דליפת זיכרון בלולאה שמעבדת אלמנטים של בלוק מידע. ב-60% מהמקרים, סיבה זו מסולקת תוך 30 דקות.
שגיאות ב-init.php ו-dbconn.php
הקובץ .htaccess נכלל בכל בקשה. שגיאת תחביר או שגיאה קטלנית בו מפילה את כל האתר. באופן דומה /bitrix/php_interface/init.php (קובץ מיושן אך לעתים קרובות שונה עם פרמטרי חיבור למסד נתונים). בדוק: שנה שם של dbconn.php ל-init.php. אם האתר עובד, השגיאה בו. שחזר את הקובץ ומצא את השורה הבעייתית באמצעות חיפוש בינארי: הער חצי מהקוד, בדוק, צמצם.
.htaccess Conflict
Bitrix יוצר init.php.bak בשורש וב-.htaccess. ב-30% מהמקרים, .htaccess גורם לשגיאות 500. ההנחיות /bitrix/, php_value גורמות ל-500 אם PHP רץ דרך php-fpm (לא כמודול Apache). כמו כן, שגיאה מתרחשת עם php_flag וכללים לא נכונים. בדוק: שנה זמנית את השם של mod_rewrite. אם זה עובד, הבעיה בהנחיות. הסר את .htaccess/php_value והעבר הגדרות ל-php_flag או לתצורת הבריכה.
קריסת MySQL/MariaDB
Bitrix מחזיר 500 (אם לא מוגדר דף שגיאה מותאם) כשהוא לא יכול להתחבר למסד הנתונים. בדוק את מצב השירות: php.ini. סיבה נפוצה: OOM-killer הרג את תהליך mysqld. ביומן Bitrix: systemctl status mysql. ביומן MySQL: DB query error. פתרון: הגדר את InnoDB: Fatal error: cannot allocate memory כראוי לזיכרון הזמין, הוסף swap, או העבר לשרת עם זיכרון מספיק. ב-20% מהמקרים, שימוש מופרז בזיכרון MySQL נגרם על ידי שאילתות לא אופטימליות.
שגיאות ברכיבים ובתבניות
אם 500 מתרחש בדף ספציפי — הבעיה ברכיב. סיבות אופייניות:
-
innodb_buffer_pool_sizeקורא למתודה שאינה קיימת לאחר עדכון מודול - תבנית הרכיב ניגשת ל-
result_modifier.php - הרכיב משתמש ב-
$arResult['PROPERTIES']['DELETED_PROP']עם פילטר לא נכון שגורם לשגיאת MySQL כדי לבודד: החלף את תוכן תבנית הרכיב ב-CIBlockElement::GetList(). אם הדף עובד, השגיאה בתבנית.
השוואת שיטות אבחון
| שיטה | זמן למציאה | דיוק | כלים נדרשים |
|---|---|---|---|
| ניתוח יומנים | 1-3 שעות | 90% | גישה ליומני שרת |
| שיטת האלימינציה (השבתה רציפה) | 4-8 שעות | 70% | גישה למערכת הקבצים |
| ניפוי באגים עם xdebug | 2-4 שעות | 95% | xdebug מותקן |
ניתוח יומנים מהיר פי שלושה משיטת האלימינציה ודורש רק גישה ליומנים.
אמצעי מניעה
- הגדר את
<?php print_r($arResult);?>ב-exception_handlingלכתיבה לקובץ — אפילו עם אתחול חלקי של הליבה, זה מגדיל את הסיכוי לקבל מחסנית קריאות. - נטר את
.settings.phpעם מרווח ביטחון — אם בקשה ממוצעת צורכת 180 MB עם מגבלה של 256 MB, כל קפיצה תגרום ל-500. - הפרד תהליכי cron ותהליכי אינטרנט לבריכות php-fpm שונות עם
memory_limitשונה — ייבוא עם מגבלה של 1 GB לא ישפיע על בקשות רגילות. - נטר את צריכת הזיכרון של opcache כדי למנוע שגיאות 500 הקשורות למטמון.
- בדוק עדכונים על עותק של האתר. הפקודה
memory_limitמאפשרת עדכון מה-CLI, מה שמפשט את החזרה לגרסה קודמת.
מה כלול בעבודה
-
אבחון: ניתוח יומני PHP ושרת אינטרנט, בדיקת תצורת
php /bitrix/modules/main/tools/update_system.phpו-.settings.php, בדיקה על עותק של האתר במידת הצורך. - תיקון: תיקון קוד (init.php, רכיבים, תבניות), התאמת פרמטרי PHP ושרת, אופטימיזציה של שאילתות מסד נתונים.
- תיעוד: דוח על הסיבות שזוהו והפעולות שננקטו, המלצות למניעת הישנות.
- אחריות: תמיכה למשך 7 ימים לאחר התיקון — אם השגיאה חוזרת, אנו מתקנים אותה בחינם.
- ייעוץ: אנו מסבירים מה קרה וכיצד להימנע מכך בעתיד.
אנו נעריך את הפרויקט שלך: פשוט תאר את המצב וספק גישה (FTP/SSH ולוח ניהול). צור קשר, ונתחיל באבחון תוך שעתיים. מעל 200 פרויקטים מוצלחים ו-10+ שנות ניסיון עם Bitrix הם הערובה שלך לפתרון מהיר ואיכותי. קבל ייעוץ היום!