Если после подключения библиотеки на странице ничего не работает, а в консоли браузера видна ошибка 404 на файл скрипта или стилей — почти всегда дело в пути: лишний или, наоборот, отсутствующий слэш перед именем файла. Браузер ищет ресурс не там, где он реально лежит, и просто не получает файл.
Как слэш ломает путь к файлу
Путь вида /assets/lib/script.js и assets/lib/script.js — это разные вещи. Первый — абсолютный, отсчитывается от корня домена. Второй — относительный, отсчитывается от текущей страницы. Если страница открыта по адресу /blog/post/, относительный путь без слэша в начале превратится в /blog/post/assets/lib/script.js — а такого файла там нет.
Двойной слэш (например, если базовый URL уже заканчивается на «/», а путь к библиотеке начинается с «/») тоже может привести к 404 на некоторых серверных конфигурациях, хотя большинство веб-серверов такие пути нормализуют.
Как проверить, где именно ошибка
- Открыть консоль разработчика (F12), вкладку Network, перезагрузить страницу и найти запрос с красным статусом — там будет виден итоговый URL, который запросил браузер.
- Сравнить этот URL с реальным расположением файла на сервере (через FTP-клиент или файловый менеджер хостинга).
- Проверить, не изменилась ли структура папок после переноса сайта или обновления CMS — часто путь «ломается» именно после переезда на другой домен или в другую директорию.
Что делать, если путь настроен верно, а файл всё равно не грузится
Стоит проверить права доступа к файлу и папке на сервере — иногда файл существует, но сервер отдаёт 403 вместо содержимого. Также имеет смысл посмотреть, не блокирует ли запрос .htaccess или конфигурация nginx (например, правило rewrite, которое перехватывает запрос к статике и отдаёт вместо неё HTML).
Если библиотека подключается через CDN, а не с локального сервера, проблема со слэшем возникает реже — но стоит убедиться, что в коде указан правильный протокол (https, а не относительный «//») и точная версия файла.
Самый надёжный способ избежать таких ошибок — использовать абсолютные пути от корня сайта или встроенные функции CMS для формирования ссылок на подключаемые файлы, а не прописывать пути вручную.