Устранение ошибки 404 Cloudflare Workers после успешного развертывания

Устранение проблем с промежуточной средой с помощью работников Cloudflare

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

После клонирования существующего репозитория Git и подключения его к промежуточной среде через Cloudflare Workers & Pages все, казалось, работало нормально. Журналы показали, что развертывание прошло успешно, что обычно сигнализирует о создании работающего экземпляра.

Но когда разработчик попытался получить доступ к данному адресу Cloudflare, появилось сообщение об ошибке 404, из-за чего он не понял, что пошло не так. Решать проблемы такого рода может быть неприятно, особенно если есть убеждение, что сервер должен быть запущен сразу после развертывания.

Неясно, нужен ли второй сервер или нужно сделать что-то еще, чтобы полностью активировать новый репозиторий. В этой статье мы рассмотрим причины этой проблемы 404 и то, как правильно настроить сервер Cloudflare Workers для промежуточной среды.

Как рабочие процессы и скрипты Cloudflare обрабатывают ошибки 404

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

Во втором примере скрипт управляет запросами с помощью Облачный работник по мере его перемещения на серверную часть. Работник использует добавитьEventListener метод для прослушивания событий и перехвата запросов на выборку, когда они выполняются. В случае возникновения ошибки 404 из-за отсутствия запрошенной страницы исполнитель динамически предоставит настроенную страницу ошибки. Эта стратегия хорошо работает для управления ответами сервера и предлагает более адаптируемый и безопасный способ обработки ошибок, особенно при работе с различными контекстами, такими как производство и промежуточный контент или динамический контент.

Чтобы убедиться, что внешние и внутренние сценарии развернуты и работают правильно, в третьем примере представлено модульное тестирование. Он выполняет автоматические тесты, чтобы проверить, возвращает ли развертывание Cloudflare Pages правильные коды состояния HTTP, используя Node.js и среда тестирования, такая как Mocha. Тесты для главной страницы (предполагающие статус 200) и тесты для несуществующей страницы (предполагающие статус 404) включены в набор тестов. Эти тесты позволяют убедиться, что все развернуто согласно плану и что любые неработающие страницы или ссылки приводят к соответствующему ответу.

Кроме того, использование тестов утверждать команд гарантирует, что любые различия в кодах состояния ответа будут обнаружены сразу. В конвейерах непрерывной интеграции и развертывания (CI/CD), где обеспечение поведения развертывания имеет решающее значение для предотвращения простоев или разрывов соединений, тесты незаменимы. Учитывая все обстоятельства, объединение перенаправления внешнего интерфейса, внутренней обработки ошибок и модульного тестирования предлагает тщательный подход, гарантирующий бесперебойную работу вашего развертывания Cloudflare Workers — даже в условиях отсутствия ресурсов или пользовательских условий, таких как промежуточный сервер.

// Frontend JavaScript for handling redirection
// This script checks if a resource is available on the Cloudflare page
// If not, it redirects to a fallback page
window.onload = function () {
  fetch(window.location.href)
    .then(response => {
      if (response.status === 404) {
        window.location.href = '/404.html';  // Redirect to custom 404 page
      }
    })
    .catch(error => {
      console.error('Error fetching the page:', error);
      window.location.href = '/error.html';  // Redirect to error page
    });
};

// Cloudflare Worker script for managing 404 errors
// The script checks if the requested path exists, and if not, returns a custom 404 page
addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request));
});
async function handleRequest(request) {
  try {
    const response = await fetch(request);
    if (response.status === 404) {
      return new Response('Custom 404 Page', { status: 404 });
    }
    return response;
  } catch (error) {
    return new Response('Error occurred: ' + error.message, { status: 500 });
  }
}

// Example unit test for deployment verification
// Using JavaScript to ensure that Cloudflare Pages return the correct response
const assert = require('assert');
const fetch = require('node-fetch');
describe('Cloudflare Deployment Test', function() {
  it('should return 200 for the main page', async function() {
    const response = await fetch('https://your-domain.pages.dev');
    assert.equal(response.status, 200);
  });
  it('should return 404 for non-existent page', async function() {
    const response = await fetch('https://your-domain.pages.dev/unknown');
    assert.equal(response.status, 404);
  });
});

Понимание промежуточной среды Cloudflare Workers

В целях разработки установка промежуточной среды может иметь решающее значение при работе с Рабочие Cloudflare. Разработчики могут тестировать свои приложения в промежуточной среде перед их развертыванием на рабочем сервере. Чтобы предотвратить такие проблемы, как указанная ошибка 404, эту среду необходимо правильно настроить при первой настройке. Разработчики часто полагают, что для запуска работающего сервера достаточно клонировать репозиторий GitHub и подключить его к Cloudflare Pages. Хотя Cloudflare автоматически развертывает статические сайты, если конфигурация маршрутизации работника настроена неправильно, могут возникнуть проблемы.

Ошибка 404 часто означает, что запрос не перехватывается должным образом. Рабочий. Пользовательские правила маршрутизации необходимы работникам Cloudflare, чтобы гарантировать отправку запросов в нужное место. Даже после запуска сайта запросы некоторых страниц могут возвращать ошибку 404, если эти маршруты не настроены. Также важно обеспечить подключение сценария Worker к промежуточному домену. Эти ошибки можно уменьшить во время разработки, используя хорошо организованный Worker и проверяя маршруты.

Сделать так, чтобы Worker все еще был подключен к вашему промежуточный домен это еще один важный шаг. Иногда Worker может не выполнить автоматическую привязку себя к новой среде во время развертывания, особенно если имеется несколько сред (например, рабочая и промежуточная). Чтобы вручную связать Worker с конкретной средой и убедиться, что он правильно обрабатывает запросы, разработчики могут использовать панель управления Cloudflare. Этот шаг необходим для бесперебойной и безошибочной работы промежуточной и производственной сред.