Wiki помощь: Ошибка 500 на сайте или в API: что означает и что делать

Ошибка 500 (Internal Server Error) означает, что сервер столкнулся с непредвиденной ситуацией и не смог выполнить запрос. Сам код не объясняет причину: для диагностики нужны журналы ошибок и обстоятельства сбоя. Если ошибка возникла при оплате, создании заказа или синхронизации, сначала проверьте результат операции, а затем решайте, можно ли повторить запрос.

На этой странице — порядок действий для посетителя сайта, владельца бизнеса и специалиста, который поддерживает обмен данными между сайтом, CRM и учетной системой.

Что делать, если появилась ошибка 500

Зафиксируйте сбой. Сохраните адрес страницы, точное время с часовым поясом, скриншот и действие, после которого появилась ошибка.
Проверьте результат операции. Убедитесь, не появился ли заказ, платеж, документ или обновление товара в целевой системе. Ответ 500 сам по себе не подтверждает, что никаких изменений не произошло.
Определите масштаб. Ошибка возникает на всем сайте, на одной странице или только при конкретном действии? Другие пользователи сталкиваются с ней?
Передайте данные ответственному специалисту. Владельцу сайта, поддержке хостинга, разработчику или команде интеграции понадобятся время сбоя и конкретный сценарий.
После исправления проверьте данные. Недостаточно увидеть, что страница снова открывается: важно проверить завершение обмена и отсутствие пропусков или дублей.

Если вы просто открывали информационную страницу, можно попробовать обновить ее через некоторое время. Если отправляли платеж или оформляли заказ, сначала уточните статус операции. Очистка кеша браузера не исправляет серверную ошибку в коде или конфигурации.

Почему возникает ошибка 500

Одинаковый статус может сопровождать разные неисправности. Таблица помогает выбрать направление проверки, но не заменяет анализ логов.

Когда появляется ошибка	Возможная причина	Что проверить
После изменения кода, обновления CMS или PHP	Ошибка приложения, несовместимость расширений	Запись об ошибке, последние изменения, совместимость версий
При обработке большого каталога	Превышение лимита памяти или времени выполнения, неэффективная обработка	Логи, длительность запуска, расход памяти, размер пакета
На одном товаре или заказе	Необработанная ситуация, связанная с данными	Идентификатор записи, входные поля, место сбоя в коде
После переноса сайта	Отличия окружения, настроек или прав доступа	Конфигурацию сервера, расширения PHP, подключение к БД, владельца файлов
При обращении к CRM или другому API	Сбой внешнего сервиса либо ошибка обработки его ответа	Какой сервер вернул 500, тело ответа, идентификатор запроса, логи интеграции
Периодически, под нагрузкой	Проблемы с ресурсами, соединениями или параллельными задачами	Метрики сервера, диск, БД, расписание и пересечение запусков

Нагрузка и тайм-ауты не всегда приводят именно к 500: в зависимости от компонента и конфигурации могут появляться другие статусы или обрыв соединения.

Ошибка 500 при синхронизации сайта, CRM и учетной системы

Сначала нужно определить, на каком участке остановился обмен и какие данные уже обработаны. Ошибка в окне браузера не позволяет судить о состоянии всей синхронизации. Если задача запущена в отдельном фоновом процессе, она может продолжать работать; если завершился сам обработчик, обмен может остановиться на части записей.

Например, при передаче каталога часть товаров может успеть обновиться до сбоя. Полный повтор без проверки результата способен повторно обработать уже переданные записи. Для заказов, платежей и документов это особенно важно.

При диагностике проверьте:

источник ответа 500: сайт, обработчик интеграции, CRM или другой внешний сервис;
последний успешный запуск и первую запись с ошибкой;
фактический результат в системе-получателе;
наличие одновременно работающих копий задачи;
способ продолжения обмена и защиту от повторного создания записей.

Если логи подтверждают проблему с объемом обработки, может помочь передача меньшими пакетами, очередь задач или оптимизация запросов. Простое увеличение лимитов не устраняет ошибку в коде и не гарантирует стабильную работу.

Что проверить владельцу сайта и разработчику

Начните с логов за точное время сбоя и сопоставьте их с конкретным запросом. Последовательная проверка обычно полезнее, чем изменение нескольких настроек одновременно.

Журналы приложения, веб-сервера и PHP. Найдите сообщение, которое соответствует ошибке. При наличии request ID используйте его для сопоставления событий.
Последние изменения. Уточните, обновлялись ли код, плагины, PHP, конфигурация или параметры подключения к внешним сервисам.
Ресурсы и ограничения. Проверьте свободное место, память, лимиты процессов и выполнения, состояние базы данных.
Настройки окружения. Проверьте нужные расширения, доступ к файлам и каталогам, настройки Apache/Nginx. Файл .htaccess имеет значение только там, где он используется.
Внешние запросы. Сохраните HTTP-статус, длительность и обезличенный ответ API; проверьте, правильно ли приложение обрабатывает ошибки внешнего сервиса.
Контрольный запуск. После исправления повторите ограниченный сценарий и проверьте конечный результат в обеих системах.

На рабочем PHP-сайте ошибки следует записывать в журнал, а не показывать посетителям: это рекомендовано в документации PHP. Не публикуйте токены API, пароли и персональные данные из логов. Не назначайте права 777 всем файлам ради устранения ошибки.

Чем ошибка 500 отличается от 502, 503 и 504

Код	Значение	Направление проверки
500 Internal Server Error	Непредвиденная ошибка при обработке запроса	Приложение, конфигурация, логи
502 Bad Gateway	Шлюз или прокси получил некорректный ответ от вышестоящего сервера	Связь прокси с обработчиком или другим сервером
503 Service Unavailable	Сервер временно не может обработать запрос, например при перегрузке или обслуживании	Доступность сервиса и нагрузка
504 Gateway Timeout	Шлюз или прокси не дождался ответа вышестоящего сервера	Длительность обработки и тайм-ауты между компонентами

Определения статусов приведены в стандарте HTTP, RFC 9110. Одинаковый внешний симптом не означает одинаковый способ исправления.

Ошибка 500 не проходит? CiFrame может проверить причину

CiFrame может помочь с диагностикой ошибки 500 на сайте или в интеграции: сопоставить ошибку с логами, определить проблемный участок обмена и подготовить рекомендации по исправлению. Объем проверки зависит от доступных журналов, доступа к системам и согласованной задачи.

Мы можем проверить:

где возникает сбой: в приложении, окружении сервера или при взаимодействии с API;
связан ли он с конкретными данными, объемом обмена или последними изменениями;
какие записи успели передаться и есть ли риск дублей при повторном запуске;
что нужно исправить в интеграции и какие вопросы передать хостингу или вашему разработчику.

По итогам диагностики вы получите установленные факты, подтвержденную причину либо перечень проверяемых гипотез, а также следующие шаги. Если для окончательного вывода нужны дополнительные логи или участие поставщика сервиса, укажем это отдельно.

Если ошибка связана с нашей интеграцией, обратитесь в поддержку CiFrame. Условия работ определяются действующим пакетом поддержки и согласованным объемом. Если интеграцию разрабатывала другая команда, можно согласовать отдельную платную диагностику; исправление и его стоимость обсуждаются после оценки.

Отправьте адрес страницы или название интеграции, время ошибки и описание действия на info@ciframe.com либо через форму ниже. Для первоначального обращения не нужны пароли или токены API.

Запросить диагностику ошибки 500

Что приложить к обращению

URL страницы или название операции, которая завершается ошибкой.
Дату, точное время и часовой пояс.
Скриншот и текст ошибки без секретных данных.
Названия систем, между которыми идет обмен.
Идентификатор проблемного заказа или товара, если он известен.
Информацию о последних изменениях и времени последнего успешного запуска.
Обезличенный фрагмент лога или request ID, если они доступны.

Даже если доступа к логам нет, отправьте время и сценарий сбоя: это поможет определить, какие сведения запросить у хостинга или разработчика.

Частые вопросы об ошибке 500

Ошибка 500 — это проблема моего компьютера?

Статус 500 сообщает об ошибке на стороне сервера. Если сбой возникает только у одного пользователя, разработчику стоит проверить сценарий, данные и сессию этого пользователя. Это не доказывает неисправность компьютера.

Можно ли исправить ошибку 500 самостоятельно?

Посетитель сайта обычно не может устранить ее причину. Владелец сайта может собрать данные о сбое и проверить последние изменения. Менять конфигурацию или код следует после выяснения причины и с возможностью отката.

Можно ли повторно запустить синхронизацию после ошибки 500?

Сначала проверьте, что уже обработано и не работает ли задача в фоне. Повтор допустим, когда понятен способ продолжения и предусмотрена защита от дублей. Для операций создания заказов, платежей и документов нельзя считать повтор безопасным только потому, что предыдущий запрос вернул ошибку.

Нужно ли менять хостинг?

Не обязательно. Причина может быть в коде, данных или настройках. Переезд обоснован, если диагностика показала ограничения инфраструктуры, которые нельзя устранить на текущем тарифе или сервере.

Сколько стоит исправить ошибку 500?

По одному HTTP-коду стоимость определить нельзя. Сначала нужно выяснить причину и объем работ. Для клиентов CiFrame учитываются условия действующей поддержки; отдельная диагностика и дальнейшие изменения согласовываются перед началом работ.

Может ли CiFrame проверить чужую интеграцию?

Можно обратиться за отдельной диагностикой. Возможность и глубина проверки зависят от доступа к логам, коду и задействованным системам. Если исправление должен выполнять ваш разработчик или хостинг, результатом проверки могут стать конкретные рекомендации для них.