Ana içeriğe geç

Yaygın Sorunlar ve Çözümler

En yaygın sorunlara ve çözümlerine kapsamlı bir kılavuz.

Kurulum Sorunları​

Kurulumdan Sonra Boş Beyaz Sayfa​

Neden: Genellikle dosya izinleri sorunu.

Çözüm:

# Laravel günlüğünü kontrol edin
tail -50 storage/logs/laravel.log

# İzinleri düzeltin
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache

"Class Not Found" (Sınıf Bulunamadı) Hataları​

Neden: Composer bağımlılıkları yüklü değil veya otomatik yükleyici oluşturulmamış.

Çözüm:

composer install --no-dev --optimize-autoloader
php artisan config:clear

Yükleyici "Zaten Kurulu" Gösteriyor​

Neden: storage/installed.lock dosyası mevcut.

Çözüm: Yükleyiciyi yeniden çalıştırmanız gerekiyorsa:

rm storage/installed.lock

Ardından /install adresini tekrar ziyaret edin.

CSS/JS Yüklenmiyor (Stilsiz Sayfa)​

Neden: Depolama sembolik bağlantısı eksik veya varlık yolu sorunu.

Çözüm:

php artisan storage:link
php artisan config:clear
php artisan view:clear

.env dosyanızdaki APP_URL değerinin gerçek alan adınızla eşleştiğini (https:// dahil) da kontrol edin.

Veritabanı Sorunları​

"SQLSTATE[HY000] [2002] Connection Refused" (Bağlantı Reddedildi)​

Neden: MySQL çalışmıyor veya yanlış host.

Çözüm:

  • MySQL'in çalıştığını kontrol edin: sudo systemctl status mysql
  • .env dosyasında localhost yerine 127.0.0.1 deneyin
  • Portu doğrulayın (varsayılan: 3306)

"SQLSTATE[HY000] [1045] Access Denied" (Erişim Reddedildi)​

Neden: Yanlış veritabanı kimlik bilgileri.

Çözüm:

  • .env dosyasındaki kullanıcı adı/şifreyi doğrulayın
  • Bağlantıyı test edin: mysql -u your_user -p your_database
  • İzinleri yeniden verin:
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'your_user'@'localhost';
FLUSH PRIVILEGES;

Emojiler ???? Olarak Görünüyor​

Neden: Veritabanı karakter seti utf8mb4 yerine utf8.

Çözüm:

ALTER DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Web Sunucusu Sorunları​

Tüm Rotalar 404 Döndürüyor​

Apache çözümü:

sudo a2enmod rewrite
sudo systemctl restart apache2

Sanal host'unuzda AllowOverride All ayarlandığından emin olun.

Nginx çözümü: Sunucu bloğunuzda şunun bulunduğundan emin olun:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

502 Bad Gateway (Nginx)​

Neden: PHP-FPM çalışmıyor veya yanlış soket yolu.

Çözüm:

sudo systemctl restart php8.4-fpm
# Soket yolunu kontrol edin
ls /var/run/php/php8.4-fpm.sock

413 Request Entity Too Large (İstek Varlığı Çok Büyük)​

Neden: Yükleme boyutu sınırı çok düşük.

Çözüm (Nginx):

client_max_body_size 20M;

Çözüm (PHP):

upload_max_filesize = 20M
post_max_size = 25M

Kimlik Doğrulama Sorunları​

"CSRF Token Mismatch" (CSRF Token Uyuşmazlığı) (419 Hatası)​

Neden: Oturum süresi dolmuş veya çerez sorunu.

Çözüm:

  • Tarayıcı çerezlerini temizleyin ve tekrar deneyin
  • .env dosyasındaki SESSION_DOMAIN değerini kontrol edin (alt alanlar için .yourdomain.com olarak ayarlayın)
  • SESSION_SECURE_COOKIE=true yalnızca HTTPS kullanıyorsanız ayarlayın

Şifre Sıfırlamanın Ardından Giriş Yapılamıyor​

Neden: Tarayıcı eski oturumu önbelleklemiş.

Çözüm: Tarayıcı çerezlerini temizleyin veya gizli mod kullanın.

Sosyal Giriş Hata Döndürüyor​

Neden: Geri dönüş URL'si uyuşmazlığı.

Çözüm: Google/GitHub konsolundaki geri dönüş URL'sinin tam olarak eşleştiğinden emin olun:

  • Google: https://yourdomain.com/auth/google/callback
  • GitHub: https://yourdomain.com/auth/github/callback

Ödeme Sorunları​

Ayrıntılı ödeme sorunları giderme için Ödeme Ağ Geçidi Sorunları sayfasına bakın.

E-posta Sorunları​

Ayrıntılı e-posta sorunları giderme için E-posta Gönderilmiyor sayfasına bakın.

Performans Sorunları​

Optimizasyon ipuçları için Performans Optimizasyonu sayfasına bakın.

Önbellek Sorunları​

Emin olamadığınızda tüm önbellekleri temizleyin:

php artisan optimize:clear

Bu şunları temizler:

  • Yapılandırma önbelleği
  • Rota önbelleği
  • Görünüm önbelleği
  • Uygulama önbelleği
  • Derlenmiş sınıf önbelleği

Hata Ayıklama Modu (Geçici)​

Ayrıntılı hata mesajlarını görmek için:

  1. .env dosyasını düzenleyin:
APP_DEBUG=true
LOG_LEVEL=debug
  1. Hatayı yeniden oluşturun
  2. Hata sayfasını veya storage/logs/laravel.log dosyasını kontrol edin
  3. İşiniz bittiğinde hemen APP_DEBUG=false olarak ayarlayın!
uyarı

Canlı ortamda APP_DEBUG=true bırakmayın. Hassas bilgileri açığa çıkarır.

Yardım Alma​

Yukarıdakilerden hiçbiri sorununuzu çözmezse:

  1. Tam hata izlemesi için storage/logs/laravel.log dosyasını kontrol edin
  2. Web sunucusu hata günlüğünüzü kontrol edin (/var/log/nginx/error.log veya /var/log/apache2/error.log)
  3. Benzer sorunlar için CodeCanyon öğe yorumlarını arayın
  4. Şunları içeren bir destek bileti açın:
    • Hata mesajı (günlükten)
    • PHP sürümü (php -v)
    • Laravel sürümü
    • Sunucu ayrıntıları (işletim sistemi, web sunucusu, MySQL sürümü)
    • Yeniden oluşturma adımları