Laravel Vite Manifest Not Found Hatası Nasıl Çözülür?

Laravel projelerinde özellikle cPanel'e taşıma, yeni sunucuya deployment veya frontend dosyalarını derlemeden production'a geçme sırasında karşılaşılan hatalardan biri:

Unable to locate file in Vite manifest

veya:

Vite manifest not found

hatasıdır.

Bu hata çoğunlukla Laravel'in @vite() ile çağırdığı frontend dosyalarının Vite tarafından henüz build edilmemiş olması, manifest.json dosyasının bulunmaması veya public/build klasörünün eksik olması nedeniyle ortaya çıkar.

Laravel Vite Nedir?

Modern Laravel sürümlerinde frontend asset'lerini yönetmek için Vite kullanılır.

Blade dosyanızda örneğin:

@vite(['resources/css/app.css', 'resources/js/app.js'])

kullanabilirsiniz.

Laravel production ortamında bu dosyaların derlenmiş halini genellikle:

public/build

altında arar.

Tipik yapı:

public/
└── build/
    ├── assets/
    │   ├── app-xxxxx.css
    │   └── app-xxxxx.js
    └── manifest.json

manifest.json yoksa Laravel asset dosyasını bulamayabilir.

Laravel Vite Manifest Not Found Neden Olur?

En yaygın nedenler:

1. npm install çalıştırılmamıştır.
2. npm run build çalıştırılmamıştır.
3. public/build klasörü sunucuya aktarılmamıştır.
4. manifest.json oluşmamıştır.
5. vite.config.js yanlış yapılandırılmıştır.
6. package.json veya package-lock.json eksiktir.
7. Node.js/npm sürümü uyumsuzdur.
8. Build işlemi hata vererek tamamlanmamıştır.
9. Yanlış Laravel dizininde build yapılmıştır.
10. cPanel deployment sırasında public/build unutulmuştur.
11. Blade dosyasında yanlış asset yolu kullanılmıştır.
12. Eski build dosyaları ile yeni kaynak dosyaları birbirinden farklıdır.

1. Önce public/build Klasörünü Kontrol Edin

Laravel projenizde:

public/build

klasörünün bulunup bulunmadığını kontrol edin.

Örneğin:

public/
├── build/
│   ├── assets/
│   └── manifest.json
├── index.php
└── ...

Eğer build klasörü hiç yoksa production asset'leri henüz oluşturulmamış olabilir.

2. package.json Dosyasını Kontrol Edin

Laravel projesinin ana dizininde:

package.json

bulunmalıdır.

Örneğin:

laravel-project/
├── app/
├── public/
├── resources/
├── routes/
├── artisan
├── composer.json
├── package.json
└── vite.config.js

package.json yoksa frontend build sürecinde problem yaşayabilirsiniz.

3. npm install Çalıştırın

Laravel projenizin ana dizininde:

npm install

çalıştırın.

Bu işlem package.json içerisinde tanımlanan frontend bağımlılıklarını yükler.

Sonrasında:

npm run build

çalıştırın.

Başarılı bir build işleminden sonra:

public/build

klasörünün oluşması beklenir.

4. En Önemli Komut: npm run build

Production Laravel uygulamasında temel işlem:

npm run build

komutudur.

Örneğin:

npm install
npm run build

Ardından:

public/build/manifest.json

oluşmalıdır.

Dosyayı kontrol etmek için:

ls -la public/build

çalıştırabilirsiniz.

5. manifest.json Var mı?

Terminal üzerinden:

ls -la public/build/manifest.json

kontrol edebilirsiniz.

Dosya varsa Laravel'in Vite entegrasyonunun okuyabileceği manifest dosyası mevcut demektir.

Yoksa build işlemini tekrar kontrol edin:

npm run build

Build sırasında hata çıkıyorsa asıl çözülmesi gereken hata odur.

6. npm run build Hata Veriyorsa

Örneğin:

npm ERR!

veya:

Module not found

gibi bir hata alıyorsanız doğrudan manifest.json oluşturmaya çalışmayın.

Önce build hatasını çözün.

Şu komutlarla temiz kurulum deneyebilirsiniz:

rm -rf node_modules

Ardından:

npm install

ve:

npm run build

Production sunucusunda node_modules silmeden önce deployment sürecinizin nasıl çalıştığını kontrol edin. Amaç çalışan uygulamanın gerekli dosyalarını yanlışlıkla silmek değildir.

7. cPanel'de Vite Manifest Hatası

cPanel Laravel kurulumlarında bu hata oldukça pratik bir şekilde ortaya çıkabilir.

Örneğin Laravel projeniz:

/home/kullanici/epiklojistikv1

altındaysa:

cd /home/kullanici/epiklojistikv1

Ardından:

npm install
npm run build

çalıştırabilirsiniz.

Sonrasında:

/home/kullanici/epiklojistikv1/public/build

oluşmalıdır.

Eğer Laravel'in public klasörünü public_html içerisine taşıdıysanız deployment yapınıza göre build çıktısının doğru public dizinde olduğundan özellikle emin olmalısınız.

8. Laravel Projesini cPanel'e Yüklerken public/build Unutulabilir

Örneğin lokal bilgisayarınızda:

public/build/

oluşmuş olabilir.

Fakat sunucuya sadece:

app/
bootstrap/
config/
database/
resources/
routes/
vendor/

yüklediyseniz public/build sunucuda bulunmayabilir.

Bu durumda Laravel:

manifest.json

dosyasını bulamaz.

Çözüm:

Lokal bilgisayarda

npm install
npm run build

Ardından

Oluşan:

public/build

klasörünü sunucudaki doğru public dizinine aktarın.

9. Node.js cPanel'de Kurulu mu?

Sunucuda build yapacaksanız Node.js ve npm gerekir.

Kontrol:

node -v

ve:

npm -v

Eğer:

command not found

gibi bir hata alıyorsanız cPanel Node.js kurulumu veya hosting sağlayıcınızın Node.js desteğini kontrol etmeniz gerekir.

10. vite.config.js Dosyasını Kontrol Edin

Laravel'in Vite yapılandırması genellikle:

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
    plugins: [
        laravel({
            input: [
                'resources/css/app.css',
                'resources/js/app.js',
            ],
            refresh: true,
        }),
    ],
});

gibi bir yapı kullanır.

Buradaki giriş dosyalarının gerçekten mevcut olduğundan emin olun:

resources/css/app.css
resources/js/app.js

Eğer vite.config.js içinde olmayan veya yanlış bir dosya tanımlandıysa build başarısız olabilir.

11. Blade Dosyanızı Kontrol Edin

Blade içerisinde örneğin:

@vite(['resources/css/app.css', 'resources/js/app.js'])

kullanıyorsanız bu dosyaların:

resources/css/app.css
resources/js/app.js

olarak gerçekten mevcut olması gerekir.

Alternatif olarak sadece:

@vite('resources/js/app.js')

kullanılıyorsa Vite yapılandırmasının buna uygun olması gerekir.

12. Vite Build Sonrası Cache Temizleyin

Build işleminden sonra Laravel cache'lerini temizlemek faydalı olabilir:

php artisan optimize:clear

Ardından:

php artisan config:cache

Production ortamında gerekiyorsa yeniden config cache oluşturabilirsiniz.

Sonrasında siteyi tekrar açın.

13. npm run dev ile npm run build Farkı

Bu iki komut sık karıştırılıyor.

Geliştirme:

npm run dev

Vite development server çalıştırır.

Production:

npm run build

Production asset'lerini oluşturur.

Canlı sitede:

Vite manifest not found

alıyorsanız sadece npm run dev çalıştırmak genellikle çözüm değildir.

Production için:

npm run build

gereklidir.

14. public/build Klasörünü Manuel Oluşturmayın

Şunu elle yapmanız doğru çözüm değildir:

public/build

klasörü oluşturup içerisine boş bir:

manifest.json

koymak.

Çünkü Laravel'in ihtiyaç duyduğu manifest dosyasının içerisinde gerçek asset eşleşmeleri bulunur.

Örneğin manifest içerisinde kaynak dosyalarının build edilmiş dosyalara eşleştirilmesi bulunur.

Dolayısıyla doğru yöntem:

npm install
npm run build

çalıştırmaktır.

15. Production İçin Önerilen Akış

Yeni bir Laravel projesini production'a gönderirken genel akış:

composer install --no-dev --optimize-autoloader

Ardından:

npm install

ve:

npm run build

Sonrasında:

php artisan optimize:clear

ve production yapılandırmasına göre:

php artisan config:cache

çalıştırılabilir.

16. Hızlı Teşhis Komutları

Şu komutlar sorunun nerede olduğunu anlamanıza yardımcı olur:

php artisan --version

node -v

npm -v

ls -la public/build

ls -la public/build/manifest.json

Ardından:

npm run build

Eğer build başarılıysa:

php artisan optimize:clear

çalıştırabilirsiniz.

17. Laravel Vite Hatası İçin Hızlı Çözüm

Yeni kurulmuş veya deployment yapılmış bir projede ilk denenecek yöntem:

npm install
npm run build
php artisan optimize:clear

Sonrasında:

public/build/manifest.json

dosyasını kontrol edin.

Dosya oluşmuşsa siteyi yeniden test edin.

18. manifest.json Var Ama Hata Devam Ediyor

Bu durumda sadece dosyanın varlığı yeterli olmayabilir.

Şunları kontrol edin:

• vite.config.js
• package.json
• resources/css
• resources/js
• Blade @vite() tanımları
• Laravel projesinin doğru public dizini
• public/build dosya izinleri
• Build'in hangi dizinde çalıştırıldığı
• Deployment sonrası eski dosyaların kalıp kalmadığı

Özellikle Laravel'in public dizinini public_html olarak kullanan cPanel kurulumlarında gerçek build çıktısının hangi fiziksel klasöre gittiği önemlidir.

19. Eski Build Dosyaları Sorun Çıkarabilir

Yeni kod yükledikten sonra eski:

public/build

dosyaları kalmış olabilir.

Özellikle deployment sırasında resources değişmiş ancak yeni build oluşturulmamışsa Laravel ile frontend dosyaları birbirinden farklı hale gelebilir.

Bu nedenle deployment sonrasında tekrar:

npm run build

çalıştırmak önemlidir.

20. Laravel Vite Manifest Hatası Kontrol Tablosu

Sık Sorulan Sorular — 20 S.S.S.

1. Laravel Vite Manifest Not Found hatası nedir?

Laravel'in Vite tarafından oluşturulması gereken manifest.json dosyasını bulamaması veya ilgili asset'i manifest içerisinde bulamaması durumudur.

2. Laravel Vite manifest nasıl oluşturulur?

Laravel projesinin ana dizininde:

npm install
npm run build

çalıştırılmalıdır.

3. Laravel Vite manifest nerede bulunur?

Production build sonrasında genellikle:

public/build/manifest.json

konumunda bulunur.

4. npm run build ne işe yarar?

Laravel projesindeki CSS, JavaScript ve diğer frontend asset'lerini production kullanımına uygun şekilde derler ve build çıktısını oluşturur.

5. npm run dev neden manifest hatasını çözmüyor?

npm run dev geliştirme sunucusunu çalıştırır. Production uygulamasında gerekli build çıktısının oluşturulması için genellikle npm run build kullanılır.

6. cPanel'de Laravel Vite nasıl build edilir?

Node.js/npm desteği bulunan bir cPanel ortamında Laravel ana dizinine geçerek:

npm install
npm run build

çalıştırabilirsiniz.

7. public/build klasörü yoksa ne yapmalıyım?

Öncelikle Laravel proje dizininde:

npm install
npm run build

çalıştırın ve build işleminin hata vermeden tamamlandığını kontrol edin.

8. manifest.json neden oluşmuyor?

npm run build işlemi başarısız olabilir. Terminaldeki build hatası incelenmeli ve öncelikle o hata çözülmelidir.

9. Laravel Vite için Node.js gerekli mi?

Vite asset'lerini build etmek için Node.js ve npm gibi JavaScript çalışma araçlarına ihtiyaç vardır. Hazır build çıktısı sunucuya aktarılıyorsa sunucuda ayrıca build yapılması gerekmeyebilir.

10. Laravel Vite hatası PHP kaynaklı mıdır?

Her zaman değil. Vite manifest hatasının doğrudan frontend build süreci, Node.js/npm, deployment veya yanlış public diziniyle ilgili olması mümkündür.

11. vite.config.js neden önemlidir?

Vite'in hangi frontend dosyalarını işleyeceğini ve Laravel ile nasıl entegre olacağını belirleyen temel yapılandırma dosyalarından biridir.

12. Laravel'de @vite() ne işe yarar?

Blade içerisinde Vite tarafından yönetilen CSS ve JavaScript asset'lerini uygulamaya dahil etmek için kullanılır.

13. Laravel Vite build yaptıktan sonra cache temizlenmeli mi?

Build sonrasında sorun devam ediyorsa:

php artisan optimize:clear

çalıştırılarak Laravel cache'leri temizlenebilir.

14. Laravel Vite cPanel'de çalışmıyorsa ne kontrol edilmeli?

Node.js, npm, Laravel proje dizini, vite.config.js, package.json, public/build ve manifest.json kontrol edilmelidir.

15. public/build/manifest.json dosyasını elle oluşturabilir miyim?

Teknik olarak bir dosya oluşturabilirsiniz ancak bu doğru çözüm değildir. Manifest dosyası Vite tarafından gerçek build sürecinde oluşturulmalıdır.

16. Laravel projesini sunucuya taşırken Vite dosyaları neden kayboluyor?

Deployment sırasında public/build klasörü aktarılmamış veya sunucuda npm run build çalıştırılmamış olabilir.

17. Laravel Vite için npm install neden gerekiyor?

package.json içerisinde tanımlanan frontend bağımlılıklarının kurulmasını sağlar. Bu bağımlılıklar Vite build sürecinde kullanılır.

18. Laravel Vite ile Tailwind arasında bağlantı var mı?

Evet, Laravel projelerinde Tailwind gibi frontend araçları Vite üzerinden build sürecine dahil edilebilir. Ancak Vite manifest hatası yalnızca Tailwind'e özgü değildir.

19. Vite build başarılı ama Laravel hâlâ manifest hatası veriyor, neden?

Yanlış public dizini, eski cache, yanlış Vite yapılandırması, yanlış deployment yolu veya Blade'deki asset tanımları kontrol edilmelidir.

20. Laravel Vite Manifest Not Found için en hızlı çözüm nedir?

Öncelikle proje ana dizininde:

npm install
npm run build
php artisan optimize:clear

komutlarını çalıştırıp ardından:

public/build/manifest.json

dosyasının oluştuğunu kontrol edin.

Sonuç

Laravel Vite Manifest Not Found hatasında ilk kontrol edilmesi gereken yer public/build klasörüdür.

Temel çözüm akışı:

npm install

npm run build

php artisan optimize:clear

Ardından:

public/build/manifest.json

dosyasının oluştuğunu kontrol edin.

Eğer npm run build hata veriyorsa, manifest dosyasını elle oluşturmaya çalışmak yerine terminaldeki build hatasını çözmek gerekir.

Özellikle cPanel üzerinde Laravel kullanırken public klasörünün public_html ile nasıl eşleştirildiği de mutlaka kontrol edilmelidir.