> For AI agents: the complete documentation index is available at /rspress-russian/llms.txt, the full documentation bundle is available at /rspress-russian/llms-full.txt.

_3 августа 2026_

# Проблема завершающего слеша в статических сайтах

## Обнаружение проблемы

История начинается с реальной проблемы, с которой столкнулся пользователь Rspress.

Пользователь разместил сайт по адресу `/next/` и использовал относительную ссылку на главной странице:

```html
<a href="./guide/start/quick-start">Quick start</a>
```

В корне домена ссылка работала независимо от того, заканчивался URL на `/` или нет. Она также корректно разрешалась, когда пользователь посещал `/next/`:

```text
/next/guide/start/quick-start
```

Однако, когда пользователь посещал `/next`, ссылка разрешалась в:

```text
/guide/start/quick-start
```

Сама страница успешно загружалась, так почему же относительная ссылка потеряла сегмент `/next`?

Эта проблема заставила меня задуматься: какую именно разницу на самом деле создаёт завершающий слеш?

### Корневой URL — особый случай

[RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986#section-6.2.3) определяет пустой путь как эквивалентный `/` для HTTP(S)-URL. Поэтому, даже если вы вводите `https://example.com`, браузер всё равно отправляет `GET /`.

### Завершающий слеш изменяет разрешение относительного URL

Браузер разрешает относительные ссылки относительно URL текущей страницы. Он рассматривает последний сегмент `/next` как имя текущего ресурса, тогда как `/next/` означает, что текущий ресурс находится внутри каталога:

```js
new URL('./guide/start', 'https://example.com/next').pathname;
// => /guide/start

new URL('./guide/start', 'https://example.com/next/').pathname;
// => /next/guide/start
```

На уровне клиентского роутера сопоставление URL обычно более либерально, чем поиск файлов на веб-сервере. Например, [React Router](https://github.com/remix-run/react-router/blob/react-router%407.18.2/packages/react-router/lib/router/utils.ts#L1576-L1578) по умолчанию не различает пути с завершающим `/` и без него. Поэтому оба приведённых ниже URL соответствуют одному и тому же маршруту с путём `/guide`:

- `/guide`
- `/guide/`

Это либеральное поведение применяется только при сопоставлении маршрутов; оно не означает, что клиент автоматически нормализует URL. React Router не удаляет `.html` и не рассматривает `/index.html` как индекс каталога. Доступность `/guide.html` и `/guide/index.html` по-прежнему зависит от дополнительной обработки со стороны фреймворка или веб-сервера.

Это объясняет, почему «страница загружается» и «относительные ссылки разрешаются корректно» — это два разных вопроса. Либеральное сопоставление помогает клиенту найти маршрут, но не изменяет URL в адресной строке. Пока в адресной строке находится `/next`, браузер разрешает относительные пути согласно первому правилу выше.

Это различие возникло ещё на заре Web, когда пути URL обычно сопоставлялись с файловыми системами. Следующие URL могли указывать на два разных статических результата:

```text
/guide.html       -> dist/guide.html
/guide/           -> dist/guide/index.html
```

Когда URL указывает на каталог, веб-сервер обычно добавляет завершающий слеш перед поиском `index.html`. Современные платформы для хостинга могут использовать rewrite-правила, чтобы отдавать одну и ту же страницу для нескольких URL, но это не меняет того, как браузеры разрешают относительные ссылки.

## Решение проблемы

Ключевой момент — обеспечить соответствие текущего URL в адресной строке предпочтительному URL, генерируемому сайтом.

Rspress [`route.cleanUrls`](/rspress-russian/api/config/config-basic.md#routecleanurls) определяет, должны ли сгенерированные URL включать расширение `.html`. Однако это влияет только на ссылки, генерируемые Rspress. Это не может помешать пользователям переходить на `/guide.html`, `/guide/` или другой вариант URL через закладки, результаты поиска или внешние сайты.

Поэтому в версии 2.1.0 Rspress вводит `route.cleanUrlsRedirect`. При запуске клиента сначала определяется фактический маршрут, а затем с помощью `history.replaceState` URL в адресной строке обновляется до формата, выбранного параметром `cleanUrls`. Например, при `cleanUrls: true`:

- `/guide.html`, `/guide/` и `/guide/index.html` → `/guide`
- `/reference/index.html` → `/reference/`

```ts title="rspress.config.ts"
import { defineConfig } from '@rspress/core';

export default defineConfig({
  route: {
    // Оба параметра будут включены по умолчанию начиная с Rspress 2.1.0.*
    cleanUrls: true,
    cleanUrlsRedirect: true,
  },
});
```

Нормализация выполняется до рендеринга страницы, не перезагружает страницу и сохраняет `base` сайта, query-параметры, hash и существующее состояние истории. В приведённом в начале примере Rspress изменяет `/next` на `/next/` до рендеринга, поэтому относительные ссылки больше не выходят за пределы `/next/`.

Начиная с Rspress 2.1.0, и `cleanUrls`, и `cleanUrlsRedirect` будут включены по умолчанию. Клиентская нормализация не может полностью заменить серверный редирект 301/308 или самостоятельно решить проблемы SEO, связанные с дублирующимися URL, но она может предотвратить ошибки приложения, вызванные несогласованными форматами URL.

Полные правила преобразования URL и сведения о конфигурации см. в [документации API `route.cleanUrlsRedirect`](/rspress-russian/api/config/config-basic.md#routecleanurlsredirect).

### Лучшие практики

URL-адреса больше не обязательно должны напрямую соответствовать файлам на диске. Использование завершающих слешей — это вопрос политики сайта, а не корректности. Браузеры и поисковые системы по-прежнему рассматривают `/about` и `/about/` как два разных URL.

Чтобы предотвратить ошибки приложения и избежать индексации одной и той же страницы по нескольким URL:

1. **Сервер:** Используйте редиректы 301/308, чтобы свести `/about` и `/about/` к одному предпочтительному URL. Варианты вроде `/about.html` и `/about/index.html` можно обрабатывать одновременно. Например, Cloudflare Workers Static Assets по умолчанию поддерживает [`auto-trailing-slash`](https://developers.cloudflare.com/workers/static-assets/routing/advanced/html-handling/): обычные HTML-файлы используют `/file`, индексные файлы каталогов — `/folder/`, а остальные варианты получают редирект 307 на соответствующий канонический URL.
2. **Клиент:** Включите `cleanUrls` и оставьте клиентский редирект в качестве запасного варианта. Если на платформе хостинга невозможно настроить редиректы, клиент может записать предпочтительный URL в самой ранней точке входа на страницу. Однако это выполняется только после загрузки HTML и JavaScript, поэтому такой подход не может полностью заменить серверный редирект.

**Следите за согласованностью всех источников URL:** внутренние ссылки, канонические URL, карты сайта и расшариваемые URL должны использовать одну и ту же предпочтительную форму. Остальные варианты должны перенаправляться на неё с помощью ответов 301/308.

**Финальные проверки:**

- `/file` и `/file/` не должны оба отдавать один и тот же контент как два независимых URL.
- Публичные URL, статический результат сборки, конфигурация Rspress и правила CDN должны придерживаться одной и той же политики использования завершающих слешей.

## Ссылки

- [RFC 3986: URI Generic Syntax](https://www.rfc-editor.org/rfc/rfc3986)
- [URL Standard](https://url.spec.whatwg.org/)
- [Apache HTTP Server: DirectorySlash](https://httpd.apache.org/docs/current/mod/mod_dir.html#directoryslash)
- [Cloudflare Workers: HTML handling](https://developers.cloudflare.com/workers/static-assets/routing/advanced/html-handling/)
- [React Router: Path matching](https://github.com/remix-run/react-router/blob/react-router%407.18.2/packages/react-router/lib/router/utils.ts#L1576-L1578)
- [Google Search Central: To slash or not to slash](https://developers.google.com/search/blog/2010/04/to-slash-or-not-to-slash)
- [Why does the trailing-slash matter? A (very) short history](https://kentgigger.com/posts/why-does-the-trailing-slash-matter-a-short-history)
