Как настроить редирект в Tomcat: URL и index.html

Быстрый ответ

Для настройки перенаправления корневого URL в Tomcat, пропишите в файле web.xml директиву welcome-file:

<welcome-file-list>
    <welcome-file>redirect.jsp</welcome-file>
</welcome-file-list>

А в файле redirect.jsp осуществите перенаправление:

<%
   response.sendRedirect("/yourApp/destinationPage");
%>

Здесь "/yourApp/destinationPage" подстройте под потребности вашего приложения для обеспечения немедленного перенаправления на сервере.

Установка контекста по умолчанию

Чтобы ваше приложение стало приложением по умолчанию в Tomcat, назовите файл WAR или директорию "ROOT":

<Context path="" docBase="ROOT" />

Атрибут docBase следует задать как "ROOT". Это позволит перенаправлять весь трафик к контексту по умолчанию.

Подробнее о web.xml

Внимательно просмотрите файл web.xml. Важно убедиться, что из него удалены устаревшие ссылки на index.html и index.jsp и что используемые паттерны перенаправления грамотно организованы.

Управление сложной архитектурой перезаписи URL

Для сложных сценариев перезаписи URL в Tomcat используйте фильтр UrlRewriteFilter и создайте в WEB-INF файл urlrewrite.xml со следующим содержимым:

<urlrewrite>
  <rule>
    <from>^/$</from>
    <to type="redirect">/app</to>
  </rule>
</urlrewrite>

Такой подход позволит вам управлять URL с большой степенью гибкости.

Опция клиентского перенаправления

Если вам больше подходит клиентское перенаправление, воспользуйтесь тегом <meta http-equiv="refresh">:

<meta http-equiv="refresh" content="0; URL='/yourApp/destinationPage'" />

Этот метод может работать немного медленнее, но он прост и подходит для начинающих.

Визуализация

Можно представить Tomcat как регулятор трафика, который направляет запросы к соответствующим контекстным путям:

   🚗 => /  ===> 🏢 (Контекст '/app')
🚗 => /app2 ==> 🏢 (Контекст '/app')
🚗 => /appN ==> 🏢 (Контекст '/app')

Tomcat обеспечивает новое путь для вашего трафика до места назначения:

<Context path="" docBase="app" />

Проверка и оптимизация конфигурации

Не забывайте регулярно тестировать и проверять конфигурацию, прежде всего при выкладке файлов и директорий в webapps. Будьте гибкими и адаптируйтесь к изменениям.

Руководство по устранению проблем

Если возникли проблемы, перепроверьте права доступа к файлам, просмотрите логи сервера на наличие ошибок и убедитесь, что UrlRewriteFilter работает корректно и urlrewrite.xml заполнен правильно.

Полезные материалы

1. Apache Tomcat Configuration Reference – The Context Container
2. Apache Tomcat 9.0 Documentation – Rewrite Valve
3. Java Community Process – JSR 369
4. Apache Tomcat Configuration Reference – The Valve Component
5. Redirecting and Remapping with mod_rewrite – Apache HTTP Server
6. YouTube – Tomcat URL Redirection Configuration