MongoDB bağlantı hatası olan connect ECONNREFUSED 127.0.0.1:27017 mesajı, uygulamanın bilgisayarındaki 127.0.0.1 adresinin 27017 portuna ulaşmaya çalıştığını, ancak bu bağlantıyı kabul eden çalışan bir MongoDB dinleyicisi bulamadığını gösterir. Sorun çoğunlukla mongod servisinin çalışmaması, farklı bir portta çalışması veya başlatılırken kapanmasıyla ilgilidir.
Çözüm için önce MongoDB servisinin durumunu kontrol et, ardından kullandığın işletim sistemine uygun şekilde servisi başlat ve mongosh ile aynı adrese bağlanmayı dene. Compass veya mongosh uygulamasını açmak, MongoDB sunucusunu kendiliğinden başlatmaz.
ECONNREFUSED 127.0.0.1:27017 neyi gösterir?
Bu hata, işletim sisteminin 127.0.0.1:27017 adresinde bağlantı kabul eden bir süreç bulamadığı anlamına gelir. 127.0.0.1 bilgisayarın kendi ağ adresidir. 27017 ise bağımsız çalışan bir mongod örneğinin istemci bağlantılarını kabul etmek için kullandığı varsayılan TCP portudur.
mongod, MongoDB verilerini yöneten ve uygulamalardan gelen bağlantıları kabul eden sunucu sürecidir. Veritabanı sunucusu çalışmıyorsa, istemci doğru adresi kullansa bile bağlantı kurulamaz. Bu nedenle hata, doğrudan kullanıcı adı veya parola problemine işaret etmez; bağlantı daha kimlik doğrulama aşamasına gelmeden reddedilmiştir.
MongoDB’nin mongosh bağlantı sözdizimi ve yerel bağlantı davranışı için resmî mongosh bağlantı belgelerine başvurabilirsin. Yerel sunucuyu belirli bir bağlantı adresiyle sınamak için şu komutu çalıştır:
mongosh "mongodb://127.0.0.1:27017"
MongoDB çalışıyorsa mongosh oturumu açılır. Bağlantının gerçekten kullanılabildiğini görmek için kabuk içinde aşağıdaki komutu çalıştırabilirsin:
db.runCommand({ ping: 1 })
Başarılı bağlantıda genel olarak { ok: 1 } sonucu görülür. Aynı ECONNREFUSED hatası devam ederse önce işletim sistemindeki MongoDB servisinin çalışıp çalışmadığını kontrol et. Servis kapalıysa aşağıdaki işletim sistemi adımlarından uygun olanını uygula. Servis başlatıldığı hâlde bağlantı kurulamazsa port, yapılandırma veya başlangıç günlükleri incelenmelidir.
MongoDB servisi Windows, macOS ve Linux’ta nasıl başlatılır?

Önce kullandığın işletim sisteminin servis yöneticisinde MongoDB’nin durumunu kontrol et. Servis duruyorsa yalnızca ilgili MongoDB hizmetini başlat. Kurulum biçimine göre hizmetin adı veya kullanılabilirliği değişebilir, bu nedenle komutun çalışmaması her zaman veritabanı dosyalarının bozuk olduğu anlamına gelmez.
Windows
MongoDB Windows hizmeti olarak kurulmuşsa Komut İstemi’ni yönetici olarak açıp şu komutu çalıştır:
net start MongoDB
Hizmet başarıyla başlarsa Windows, MongoDB hizmetinin başlatıldığını belirten bir çıktı gösterir. Hizmet zaten çalışıyorsa bunu belirten bir mesaj alabilirsin. Hizmetin çalışır durumda olduğunu Windows’un hizmet yöneticisindeki durum bilgisinden de doğrula.
macOS
MongoDB Homebrew üzerinden kurulduysa macOS Terminali’nde şu komutla servisi başlatabilirsin:
brew services start mongodb-community
Komutun ardından Homebrew, servisin başlatıldığını veya kayıt altına alındığını belirten bir çıktı verir. MongoDB kurulumunda sürümlü bir Homebrew formülü kullanıldıysa servis adı kurulumdaki formülle eşleşmelidir.
Linux
MongoDB paket yöneticisiyle kurulmuş ve sistemd kullanan bir Linux dağıtımında servisi şu komutla başlat:
sudo systemctl start mongod
Komut başarıyla tamamlandığında terminal her zaman ayrıntılı bir başarı mesajı göstermeyebilir. Bu durumda servis yöneticisindeki durumun çalışır olduğunu kontrol et ve ardından mongosh "mongodb://127.0.0.1:27017" komutuyla bağlantıyı yeniden dene. mongod birim olarak bulunamıyorsa kurulumun servis kaydı oluşturup oluşturmadığı ayrıca incelenmelidir.
Port ve bağlantı adresi neden uyuşmayabilir?
ECONNREFUSED 127.0.0.1:27017 hatasında istemci, 127.0.0.1 adresindeki 27017 portuna ulaşmaya çalışır. Bağlantının kurulabilmesi için mongod işleminin gerçekten bu ana bilgisayar ve port üzerinde dinlemesi gerekir. MongoDB yapılandırmasında net.port istemcilerin bağlanacağı TCP portunu, net.bindIp ise sunucunun dinleyeceği adresleri belirler. Ayrıntılar için MongoDB yapılandırma seçeneklerine bakabilirsin.
Örneğin yapılandırmada port 28015 olarak ayarlanmışsa 27017 üzerinden bağlantı denemek reddedilir. Aynı durum bağlantı dizesinde portun yanlış yazılması veya uygulamanın farklı bir yapılandırma dosyasıyla başlatılması için de geçerlidir. Önce yapılandırmadaki port ve bindIp değerlerini, ardından mongod loglarında görülen dinleme adresi ve port bilgilerini karşılaştır.
mongosh "mongodb://127.0.0.1:27017"
db.runCommand({ ping: 1 })
Bu komut, sunucu gerçekten 127.0.0.1:27017 üzerinde çalışıyorsa bağlantı kurar ve { ok: 1 } sonucunu döndürür. Sunucu başka bir portta çalışıyorsa bağlantı dizesini o porta göre değiştirmen gerekir.
localhost ve 127.0.0.1 çoğu yerel kurulumda aynı bilgisayarı hedefler. Ancak localhost bir ana bilgisayar adı olduğu için sistem tarafından IPv4 veya IPv6 adresine çözümlenebilir. Tanı sırasında 127.0.0.1 kullanmak, ana bilgisayar adı çözümlemesini aradan çıkararak IPv4 yerel bağlantısını açıkça test etmeye yardımcı olur.
bindIp yalnızca belirli bir yerel adrese ayarlanmışsa, istemcinin kullandığı diğer adres üzerinden bağlantı kurulamayabilir. Sorunu çözmek için doğrudan 0.0.0.0 kullanma. Bu değer MongoDB'yi tüm IPv4 arayüzlerinde dinlemeye yönlendirebilir ve uygun güvenlik önlemleri alınmadığında veritabanını dış ağlara açabilir. Güvenlik duvarını değiştirmek de sunucunun çalıştığı ve doğru portu dinlediği doğrulanmadan önceki adım olmamalıdır.
mongod açılıp kapanıyorsa log dosyası nasıl okunur?

mongod başlatıldıktan hemen sonra kapanıyorsa log dosyası, başlangıç sorununu anlamak için ilk incelenecek kaynaklardan biridir. Logun konumu kurulum biçimine göre değişebilir; yapılandırmadaki systemLog.path değerini veya MongoDB servisinin kullandığı yapılandırma dosyasını kontrol et. systemLog.path tanımlı değilse çıktı dosyaya değil, standart çıktıya yazılabilir.
- Log dosyasının son kayıtlarını aç. Sunucunun kapanmasına en yakın satırlar genellikle daha açıklayıcıdır.
- Hata seviyesindeki kayıtları ve hemen öncesindeki satırları birlikte incele. Tek bir satırı bağlamından koparmak yanlış teşhise yol açabilir.
storage.dbPathdeğerini kontrol et. Bu yol, MongoDB'nin veri dosyalarını tuttuğu klasörü gösterir.- Klasörün gerçekten var olduğunu ve
mongodişlemini çalıştıran kullanıcının bu klasörde okuma ve yazma yetkisi bulunduğunu doğrula. - Port çakışması, yapılandırma yazım hatası ve veri klasörüne erişim sorunlarını birbirinden ayır.
Veri klasörünün bulunmaması veya erişilememesi, MongoDB'nin başlatılır başlamaz kapanmasına neden olabilir. Loglarda benzer biçimde portun başka bir işlem tarafından kullanıldığını ya da yapılandırmanın okunamadığını gösteren kayıtlar da bulunabilir. Bu nedenle yalnızca hata mesajının genel biçimine bakarak tek bir sebep seçmek yerine, dbPath, izinler, port ve yapılandırma satırlarını logdaki asıl kayıtlarla karşılaştır.
MongoDB'nin yapılandırma ve log seçenekleri bu değerlerin nereden okunduğunu açıklar. Yapılandırma dosyasında log yolu veya veri yolu değiştirildiyse, değişikliklerin etkili olması için çalışan sunucuyu yeniden başlatman gerekir.
Docker içinde 127.0.0.1 neden MongoDB’ye ulaşmaz?
Uygulama bir Docker konteyneri içinde çalışıyorsa 127.0.0.1 çoğu durumda ana bilgisayarı veya başka bir konteyneri değil, uygulamanın bulunduğu konteynerin kendi döngüsel adresini gösterir. MongoDB ayrı bir konteynerde çalıştığında uygulama, kendi konteynerindeki boş portu aradığı için ECONNREFUSED 127.0.0.1:27017 hatası alabilir.
Uygulama ve MongoDB aynı Docker ağına bağlıysa bağlantı hedefi olarak MongoDB servisinin adını, port olarak da MongoDB’nin konteyner içinde dinlediği portu kullanmalısın. Docker Compose, servisleri aynı varsayılan ağa ekler ve servis adlarını konteynerler arasında çözülebilen adresler hâline getirir. Bu nedenle MongoDB servisi mongodb adıyla tanımlandıysa bağlantı adresi şu biçimde olabilir:
mongodb://mongodb:27017
Buradaki mongodb servis adıdır. 27017 ise konteyner içindeki porttur. Docker Compose yapılandırmasında örneğin 28017:27017 eşlemesi bulunuyorsa, 28017 ana makinedeki, 27017 ise konteyner içindeki portu ifade eder. Aynı Docker ağı içindeki uygulama genellikle ana makine portu olan 28017 yerine konteyner portuna bağlanır.
mongodb://mongodb:27017
mongodb://localhost:28017
mongodb://host.docker.internal:27017
Bu üç adres farklı bağlantı senaryolarını gösterir. İlk adres, aynı Docker ağı içindeki uygulamanın MongoDB konteynerine ulaşması içindir. İkinci adres, uygulama ana makinede çalışırken MongoDB konteynerinin ana makineye yayımlanmış portuna bağlanmak için kullanılabilir. Üçüncü adres ise Docker Desktop ortamında, uygulama konteynerinden ana makinede çalışan bir servise ulaşmak için kullanılan özel ana makine adıdır.
Ana makinede çalışan MongoDB’nin kendi yapılandırmasında yalnızca yerel arayüzü dinlemesi de bağlantıyı etkileyebilir. Bu durumda konteynerden ana makineye ulaşılması, Docker ortamının kullandığı ana makine adresiyle MongoDB’nin dinlediği arayüz ve portun birlikte değerlendirilmesini gerektirir. Önce uygulamanın nerede, MongoDB’nin nerede çalıştığını ve hangi portun yayımlandığını netleştir.
Sorunu güvenli biçimde hangi sırayla teşhis etmelisin?
En güvenli teşhis sırası, önce MongoDB sunucusunun çalışıp çalışmadığını, ardından bağlantı adresiyle portun uyuşup uyuşmadığını kontrol etmektir. Bu iki bilgi doğrulanmadan güvenlik duvarı kuralı değiştirmek veya MongoDB’yi daha geniş bir ağa açmak sorunun kaynağını gizleyebilir.
- Sunucunun durumunu kontrol et.
mongodsüreci veya ilgili servis çalışmıyorsa istemci bağlantıyı kabul edecek bir işlem bulamaz. Servis kapalıysa işletim sistemine uygun servis yönetimiyle başlat. - Başlatma durumunu incele. Servis başlatılıyor gibi görünüp hemen kapanıyorsa log dosyasını oku. Eksik veri klasörü, dosya izinleri, yapılandırma hatası veya port çakışması gibi nedenler burada görülebilir.
- Adres ve portu karşılaştır. İstemcinin
localhost,127.0.0.1, bir servis adı veya ana makine adresi kullanıp kullanmadığını kontrol et. Ardından MongoDB’nin gerçekten dinlediği portu, Docker kullanılıyorsa ana makine portu ile konteyner portunu ayrı ayrı değerlendir. - Docker ağını kontrol et. Uygulama konteynerdeyse
127.0.0.1yerine aynı ağdaki MongoDB servis adını kullan. MongoDB ana makinedeyse Docker ortamının ana makineye erişim yöntemini ve MongoDB’nin kabul ettiği arayüzü kontrol et. - Ağ ve güvenlik ayarlarını en son değerlendir. Önceki kontroller somut bir ağ erişimi sorununa işaret ediyorsa güvenlik duvarı, ağ yönlendirmesi ve
bindIpyapılandırmasını incele.
bindIp değerini doğrudan 0.0.0.0 yapmak güvenli bir ilk çözüm değildir. Bu değer MongoDB’nin tüm IPv4 arayüzlerinde dinlemesine neden olabilir ve veritabanını daha geniş bir ağa erişilebilir hâle getirebilir. Benzer şekilde kimlik doğrulamayı kapatmak, erişim denetimini ortadan kaldırarak yetkisiz istemcilerin veritabanına erişme riskini artırır. MongoDB belgeleri, yalnızca güvenilir ağların erişmesine izin verilmesini ve dış arayüzlere bağlamadan önce güvenlik önlemlerinin alınmasını önerir.
Sık Sorulan Sorular
ECONNREFUSED 127.0.0.1:27017 hatası MongoDB sunucusunun kapalı olduğu anlamına mı gelir?
Bu hata, istemcinin 127.0.0.1:27017 adresinde bağlantıyı kabul eden bir MongoDB sunucusuna ulaşamadığını gösterir, ancak tek başına sunucunun kesinlikle kapalı olduğunu kanıtlamaz. MongoDB başka bir portta çalışıyor olabilir, farklı bir arayüze bağlı olabilir veya uygulama Docker içindeyse 127.0.0.1 yanlış konteyneri gösteriyor olabilir.
mongod servisi çalışıyor göründüğü hâlde 27017 portuna neden bağlanamıyorum?
mongod süreci çalışsa bile MongoDB farklı bir portta dinliyor, yalnızca belirli bir arayüze bağlanmış veya uygulama yanlış ağ hedefini kullanıyor olabilir. Docker ortamında ana makineye yayımlanan port ile konteyner içi portun aynı olmadığını ve uygulamanın doğru hedef adıyla bağlandığını kontrol etmelisin.
localhost ile 127.0.0.1 arasında MongoDB bağlantısı açısından ne fark vardır?
localhost bir ana bilgisayar adıdır, 127.0.0.1 ise IPv4 döngüsel adresidir ve çoğu yerel kurulumda aynı bilgisayarı gösterir. Ancak Docker konteynerinde bu adresler ana makineyi değil, bağlantıyı başlatan konteynerin kendi yerel ağ alanını gösterebilir.
Docker konteynerindeki uygulama MongoDB’ye bağlanırken neden 127.0.0.1 kullanmamalıdır?
Docker konteynerindeki 127.0.0.1 uygulama konteynerinin kendisini gösterir. MongoDB başka bir konteynerdeyse uygulama aynı Docker ağındaki servis adını, MongoDB ana makinedeyse ortamın ana makine erişim adresini kullanmalıdır.
Bu hatayı çözerken önce çalışan sunucuyu, sonra doğru adres ve portu, ardından logları ve Docker ağını kontrol etmek en sağlıklı yaklaşımdır. Güvenlik ayarlarını değiştirmek ise ancak bağlantı sorununun nedeni gerçekten bu ayarlara bağlandıktan sonra değerlendirilmelidir.