MySQL / MariaDB bağlantı sorununuz için kontrol listesi
MYSQL / MARIADB · 3306
MySQL / MariaDB bağlantı sorununuz için kontrol listesi
Hata türünü ve istemci ortamını seçin. Size uygun adımları ve komut örneklerini alın; sunucu adı, kullanıcı veya parola girmeniz gerekmez.
Bu bölüm komut çalıştırmaz veya sunucuya bağlanmaz. Komutlardaki örnek adresi ve portu kendi yetkili ortamınıza göre değiştirin. Paylaşılan bağlantıda yalnız seçilen hata, ortam ve istemci bulunur.
Seçiminize göre kontrol listesi
Hata türüne göre ilk kontroller
Bağlantı reddedildi / Connection refused
Tam mesaj bağlantı reddi gösteriyorsa bu dalı kullanın. MySQL 2003/10061, MariaDB istemcisi ise 2002 gösterebilir; socket yolu varsa yerel socket dalını seçin.
- Kontrolü hatalı uygulamanın çalıştığı makine veya konteyner ağından yapın.
- Hedef portta dinleyen servis ile uygulamanın sunucu ve port ayarlarını karşılaştırın.
- Açık ret, dinleyici eksikliği veya ağ erişim kuralından kaynaklanabilir; yalnız hata koduyla neden seçmeyin.
Sonraki adım: TCP testi başarılıysa uygulamadaki tam hataya dönün. Başarısızsa sunucu yöneticisiyle dinleyiciyi ve izinli kaynak ağını kontrol edin.
Zaman aşımı / Connection timed out
İstemci bağlantı için bekliyor ve zaman aşımına düşüyorsa bu dalı kullanın.
- Uygulamanın kullandığı sunucu adının beklenen IP adresine çözüldüğünü kontrol edin.
- VPN, özel ağ ve bulut erişim kurallarını uygulamanın kaynak ağıyla karşılaştırın.
- Süreyi artırmadan önce erişim yolunu inceleyin; zaman aşımı tek başına güvenlik duvarını kanıtlamaz.
Sonraki adım: Kendi ağınızdaki sonucu dışarıdan yapılan port testiyle ayrı değerlendirin. Özel veritabanının internete kapalı olması beklenen davranış olabilir.
1045 — Access denied
Veritabanı kimlik doğrulama isteğini reddediyorsa bu dalı kullanın.
- İstemcinin doğru ortam ve sunucuya bağlandığını doğrulayın.
- Yetkili yöneticiyle kullanıcı-hosta göre hesap eşleşmesini, yetkileri ve kimlik doğrulama yöntemini inceleyin.
- Parolayı destek kaydına eklemeyin; başarısız girişleri otomatik olarak tekrarlamayın.
Sonraki adım: Ağ bağlantısı kurulduktan sonraki kimlik doğrulama hatası için rastgele port açmayın. Hesap ayarı düzeltildiğinde asıl uygulama isteğini yeniden kontrol edin.
2002 — Yerel socket bağlantısı
Mesajda socket yolu geçiyorsa TCP testiyle farklı bir bağlantı türünü sınadığınızı unutmayın.
- İstemci ve sunucunun aynı makinede olup olmadığını belirleyin.
- İstemcinin beklediği socket yolu ile sunucunun kullandığı yolu karşılaştırın.
- TCP karşılaştırmasını yalnız yerel sunucunuz TCP dinliyorsa ve hesabınız bu bağlantıya yetkiliyse yapın.
Sonraki adım: Socket dosyasını gelişigüzel silmeyin. TCP ile başarı, socket yolunun veya izinlerinin doğru olduğunu göstermez.
2005 — Unknown server host
Sunucu adı çözümlenemiyorsa önce adlandırma yolunu inceleyin.
- Sunucu adında yazım hatası veya yanlış ortam adı olup olmadığını kontrol edin.
- Adı uygulamanın çalıştığı ağda çözümleyin; özel DNS veya konteyner servis adı dışarıdan çalışmayabilir.
- DNS cevabını beklenen adresle karşılaştırın; DNS başarısı TCP veya oturum açma başarısı değildir.
Sonraki adım: Doğru ağda isim çözümleme çalıştıktan sonra aynı sunucu ve portla bağlantı adımına geçin.
Tüm vakaların kontrol listesini indir
Bu bir teşhis kontrol listesidir; nedenin bulunduğu veya sorunun çözüldüğü anlamına gelmez.
2002, 2003 ve 1045: gerçek deneyde ne değişiyor?
9 Kasım 2026’da MySQL 8.4.13 ve MariaDB 11.4.13 istemcilerini kendi sunucularıyla ayrı Linux Docker konteynerlerinde sınadık. Her motor için aynı dört kontrol çalıştı. Dış ağ ve yayımlanan host portu yoktu; testler konteynerin kendi loopback adresini kullandı. İki konteyner ve geçici verileri temizlendi. Bunlar müşteri vakası değil, tekrarlanabilir kontrollü deney sonuçlarıdır.
| Bağlantı | MySQL 8.4.13 | MariaDB 11.4.13 | Yorum |
|---|---|---|---|
TCP 127.0.0.1:3307 | 2003 / HY000 | 2002 / HY000 | Dinleyici yok; bağlantı reddi. Önce adres, port ve dinleyiciyi kontrol edin. |
TCP 127.0.0.1:3306 | 1045 / 28000 | 1045 / 28000 | Bilerek yanlış parola verildi; sunucuya ulaşıldı ve kimlik doğrulama reddedildi. |
SOCKET /tmp/cybertool-absent.sock | 2002 / HY000 | 2002 / HY000 | Olmayan Unix soket yolu. TCP portunu değiştirmek bu yolu düzeltmez. |
TCP 127.0.0.1:3306 | SELECT 1 → 1; exit 0 | SELECT 1 → 1; exit 0 | Aynı sunucu ve port, doğru geçici parola: başarılı kontrol. |
Aynı TCP reddi MySQL istemcisinde 2003, MariaDB istemcisinde 2002 verdi. Olmayan socket ise ikisinde de 2002 verdi. Bu yüzden yalnız hata numarasıyla katmanı belirlemeyin; istemciyi, transport türünü ve tam mesajı okuyun. 1045 bu deneyde yanlış parola nedeniyle üretildi; gerçek sistemde kullanıcı-host eşleşmesi veya kimlik doğrulama yöntemi de sebep olabilir. Sonuçlar bu sürümlere ve Linux ortamına aittir; Windows native istemcisi sınanmadı.
Docker içindeki localhost neden yanıltır?
Uygulama ile veritabanı ayrı konteynerlerdeyse, uygulamadaki 127.0.0.1 uygulama konteynerinin kendisidir. Aynı Docker ağındaki Compose servis adı ve konteyner portunu kullanın; örneğin db:3306. Host üzerinde 3307:3306 eşlemesi olması, diğer konteynerin db:3307 kullanması gerektiği anlamına gelmez. Yukarıdaki deney istemciyi bilerek veritabanı konteynerinin içinde çalıştırır; bu nedenle 127.0.0.1 burada doğrudur. Gerçek uygulama için testi uygulamanın ağından tekrarlayın.
Deneyi kendiniz tekrarlayın
Python 3 ve çalışan Docker gerekir. Paketi çıkarıp aşağıdaki komutları çalıştırın. Her çalıştırma bir geçici konteyner oluşturur; MySQL için 1 GB, MariaDB için 512 MB bellek ve 1 CPU sınırı kullanır. Dört sonucu denetler ve temizler. Betik parolaları çıktıya veya sonuç dosyalarına yazmaz. Çalışırken süreç/konteyner ortamında bulunurlar; Docker erişimi olan yöneticiler bunları görebilir. İlk imaj indirmesi internet gerektirir; deneyin ağı kapalıdır. İmaj etiketleri değişebilir; kullanılan sürüm ve digest paket içindeki iki sonuç JSON dosyasında kayıtlıdır.
docker pull mysql:8.4
python3 mysql_connection_lab.py --engine mysql
docker pull mariadb:11.4
python3 mysql_connection_lab.py --engine mariadb
Deney betiği ve sonuçları içeren paket · GitHub
Kaynaklar: MySQL connection troubleshooting · Docker Compose networking
Aynı uygulama, iki hata: hangi kontrol yapılmalı?
Varsayımsal örnek: Windows uygulaması, yetkili özel ağdaki veritabanına bağlanamıyor. Aşağıdakiler gerçek sunucu çıktısı veya çözülmüş müşteri vakası değildir.
A — 2003 / Connection refused / 10061
TCP bağlantısı reddedilmiş. Uygulamanın çalıştığı ağdan hedef adres ve yapılandırılmış portu kontrol edin; yöneticiyle dinleyen servisi karşılaştırın. Farklı bir bilgisayardan başarılı test, uygulamanın erişimini kanıtlamaz.
Bu örneğin kontrol listesini aç
B — 1045 / Access denied
Sunucu kimlik doğrulamayı reddetmiş. Önce doğru ortama ulaşıldığını, ardından kullanıcı-hosta göre hesap eşleşmesini ve kimlik doğrulama yöntemini yöneticiyle kontrol edin. Bu mesaj tek başına yanlış parola kanıtı değildir.
Bu örneğin kontrol listesini aç
Her örnekten kendi kontrol listenize geçebilirsiniz. Özel veritabanını internete açmak veya güvenlik duvarını kapatmak bu örneklerin çözümü değildir.
Güncel web rehberi · cyber-tool.org