Laravel: Vite manifest not found — не собраны стили и скрипты
Стили и скрипты сайта на Laravel собирает программа Vite. Готовые файлы и их список — файл manifest.json — лежат в папке public/build. Эта папка не хранится в Git, поэтому на сервере её нет, пока вы не соберёте файлы. Ошибка значит, что Laravel ищет список файлов и не находит его.
Содержание 11
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Проверьте версию Node.js:
node -v. Нужна 20.19 или новее в ветке 20, либо 22.12 и новее — почему. - Установите пакеты:
npm install. - Соберите файлы:
npm run build. - Обновите страницу сайта.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). В папке проекта лежат файлы artisan и package.json.
Если Node.js на сервере ставить не хотите, соберите файлы на своём компьютере — как.
Как выглядит ошибка
Vite manifest not found at: /var/www/example.com/public/build/manifest.jsonС APP_DEBUG=true в файле .env текст виден на странице. С APP_DEBUG=false посетитель видит 500 и Server Error, а ошибка записана в storage/logs/laravel.log.
Ошибку вызывает строка @vite(...) в шаблоне страницы. Она подключает стили и скрипты и за адресами файлов идёт в manifest.json.
Проверьте, есть ли файл:
ls public/build/Если папки нет или в ней нет manifest.json, файлы не собраны.
Почему так бывает
В файле .gitignore нового проекта Laravel есть строка /public/build. Git не хранит собранные файлы: их собирают заново там, где сайт работает. Если проект скачали на сервер командой git clone или git pull, папки public/build нет.
Вторая причина — файлы собрали в другую папку. Laravel ищет список там, где указано в строке @vite. Без второго параметра — в public/build.
Как собрать файлы
В папке проекта:
npm install
npm run build| Команда | Что делает |
|---|---|
npm install | ставит Vite и плагин Laravel в папку node_modules по списку из package.json |
npm run build | собирает стили и скрипты в public/build и пишет список файлов public/build/manifest.json |
Если в папке есть файл package-lock.json, вместо npm install можно выполнить npm ci — она ставит те же версии пакетов, что у разработчика.
После сборки проверьте: ls public/build/manifest.json. Файл на месте — обновите страницу.
Собирайте файлы после каждого обновления проекта, в котором поменялись стили или скрипты.
Если файлы собирали через sudo, папка public/build принадлежит root. Сайт её прочитает, но следующая сборка от вашего пользователя не сможет их заменить. Собирайте без sudo.
Какая версия Node.js нужна
В новом проекте Laravel 13 стоит Vite 8 и плагин laravel-vite-plugin 3. Оба требуют Node.js версии 20.19 и новее в ветке 20 или 22.12 и новее.
| Ubuntu | Node.js из пакета | Подходит для Vite 8 |
|---|---|---|
| 24.04 | 18.19.1 | нет |
| 26.04 | 22.22.1 | да |
На Ubuntu 24.04 Node.js из пакета nodejs слишком старый. npm install предупредит строкой npm WARN EBADENGINE — что она значит. Vite 8 на этой версии не поддерживается. Поставьте выпуск LTS с сайта Node.js — как это сделать.
Какие версии требует ваш проект, видно в package.json: строки "vite" и "laravel-vite-plugin".
Если собирать на сервере не хотите
Соберите файлы на своём компьютере и загрузите папку public/build на сервер. На компьютере, в папке проекта:
npm install
npm run build
rsync -avz public/build/ user@203.0.113.10:/var/www/example.com/public/build/Вместо user — ваш пользователь на сервере, вместо 203.0.113.10 — адрес сервера. Как работает команда — в справочнике rsync. Если rsync нет, подойдёт scp.
Загружайте папку целиком: manifest.json ссылается на файлы из public/build/assets.
Если сборка падает от нехватки памяти
На сервере с 1 ГБ памяти сборка может оборваться ошибкой JavaScript heap out of memory. Как добавить память или файл подкачки — в разборе этой ошибки. Ещё один выход — собрать файлы на компьютере.
Если стили не грузятся, а в адресах порт 5173
Ошибки нет, но страница без оформления. В коде страницы стили подключены с адреса вроде http://localhost:5173/... — это сервер разработки Vite.
Так бывает, если в папке public остался файл hot. Его создаёт команда npm run dev и удаляет при выходе. Если процесс завершили принудительно или скопировали проект, пока он работал, файл остаётся. Пока файл есть, Laravel берёт стили и скрипты с сервера разработки, а не из public/build.
Удалите файл:
rm public/hotНа рабочем сайте npm run dev не запускайте — только npm run build.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Vite manifest not found at: …/public/build/manifest.json | файлы не собраны | npm install и npm run build |
npm WARN EBADENGINE при npm install | Node.js старее, чем нужно Vite | поставьте Node.js новее |
| команда npm не найдена | Node.js не установлен | Установка Node.js |
JavaScript heap out of memory | не хватило памяти при сборке | Разбор |
| стили грузятся с порта 5173 | остался файл public/hot | удалите public/hot |
500 и Server Error | ошибка в журнале Laravel | Разбор |
Текст сообщения сверен по исходному коду Laravel 13.42.0, требования к Node.js — по файлам package.json пакетов vite 8.3.8 и laravel-vite-plugin 3.2.1.
Источники
- Документация Laravel: Asset Bundling (Vite) — на английском: npm run dev, npm run build и строка @vite.
- Исходный код класса Vite в Laravel 13.42.0 — на английском: текст Vite manifest not found и файл hot.
- Плагин laravel-vite-plugin — на английском: где плагин создаёт и удаляет файл hot.
- Файл .gitignore нового проекта Laravel — на английском: строки /public/build и /public/hot.
- Пакет nodejs в Ubuntu 24.04 — на английском: версия 18.19.1.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- Как установить Node.js на Ubuntuкакая версия ставится и где взять новее.
- Ошибки Node.js и npmчто делать, если npm не ставит пакеты.