MongoDB Connection Error Çözümü: ECONNREFUSED ve Timeout Hataları (2025)

Hata Mesajı 1: ECONNREFUSED

MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
    at connectionFailureError
Error: connect ECONNREFUSED 127.0.0.1:27017

Hata Mesajı 2: Timeout

MongooseServerSelectionError: connect ETIMEDOUT
MongoTimeoutError: Server selection timed out after 30000 ms

Hata Mesajı 3: Authentication Failed

MongoError: Authentication failed
MongoServerError: bad auth : Authentication failed

Linux/Ubuntu'da Kontrol

# Servis durumunu kontrol et
sudo systemctl status mongod

# Eğer çalışmıyorsa başlat
sudo systemctl start mongod

# Otomatik başlatmayı aktifleştir
sudo systemctl enable mongod

Windows'ta Kontrol

# PowerShell'de (Admin olarak)
Get-Service MongoDB

# Servisi başlat
Start-Service MongoDB

# veya Services.msc'den:
1. Windows + R tuşla
2. services.msc yaz
3. MongoDB Server bul
4. Sağ tık > Start

macOS'ta Kontrol

# Homebrew ile kurulduysa
brew services list

# Başlat
brew services start mongodb-community

# veya manuel
mongod --config /usr/local/etc/mongod.conf

Doğru Connection String Formatları

// Yerel bağlantı (Local connection)
mongodb://localhost:27017/mydb

// Authentication ile
mongodb://username:password@localhost:27017/mydb

// Replica Set ile
mongodb://localhost:27017,localhost:27018/mydb?replicaSet=rs0

// MongoDB Atlas
mongodb+srv://username:password@cluster.mongodb.net/mydb

// ❌ YANLIŞ - Eksik protokol
mongoose.connect('localhost:27017/mydb');

// ❌ YANLIŞ - Yanlış port
mongoose.connect('mongodb://localhost:27018/mydb');

// ✅ DOĞRU
mongoose.connect('mongodb://localhost:27017/mydb');

// ✅ DOĞRU - Options ile
mongoose.connect('mongodb://localhost:27017/mydb', {
  useNewUrlParser: true,
  useUnifiedTopology: true
});

Ubuntu/Debian - UFW

# Port durumunu kontrol et
sudo ufw status

# MongoDB portunu aç
sudo ufw allow 27017

# Sadece belirli IP'den izin ver (daha güvenli)
sudo ufw allow from 192.168.1.0/24 to any port 27017

CentOS/RHEL - firewalld

# Portu aç
sudo firewall-cmd --zone=public --add-port=27017/tcp --permanent

# Firewall'ı yeniden yükle
sudo firewall-cmd --reload

Windows Firewall

# PowerShell (Admin)
New-NetFirewallRule -DisplayName "MongoDB" -Direction Inbound -Protocol TCP -LocalPort 27017 -Action Allow

# veya Windows Defender Firewall'dan:
1. Control Panel > Windows Defender Firewall
2. Advanced Settings
3. Inbound Rules > New Rule
4. Port > TCP > 27017 > Allow

mongod.conf Dosyası

# Linux: /etc/mongod.conf
# Windows: C:\Program Files\MongoDB\Server\7.0\bin\mongod.cfg
# macOS: /usr/local/etc/mongod.conf

# Varsayılan (sadece localhost)
net:
  port: 27017
  bindIp: 127.0.0.1

# Tüm IP'lerden bağlantı (DİKKAT: Güvenlik riski!)
net:
  port: 27017
  bindIp: 0.0.0.0

# Belirli IP'ler (Önerilen)
net:
  port: 27017
  bindIp: 127.0.0.1,192.168.1.100

Değişiklik Sonrası Restart

# Linux
sudo systemctl restart mongod

# Windows
Restart-Service MongoDB

# macOS
brew services restart mongodb-community

Mongoose Timeout Options

const mongoose = require('mongoose');

mongoose.connect('mongodb://localhost:27017/mydb', {
  serverSelectionTimeoutMS: 5000,   // Server seçim timeout
  connectTimeoutMS: 10000,          // Bağlantı timeout
  socketTimeoutMS: 45000,           // Socket timeout
  maxPoolSize: 10,                  // Max connection pool
  minPoolSize: 2                    // Min connection pool
});

MongoDB Native Driver

const { MongoClient } = require('mongodb');

const client = new MongoClient('mongodb://localhost:27017', {
  serverSelectionTimeoutMS: 5000,
  connectTimeoutMS: 10000,
  socketTimeoutMS: 45000
});

await client.connect();

docker-compose.yml Örneği

version: '3.8'
services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - MONGO_URI=mongodb://mongo:27017/mydb
    depends_on:
      - mongo

  mongo:
    image: mongo:7
    ports:
      - "27017:27017"
    volumes:
      - mongo-data:/data/db

volumes:
  mongo-data:

Docker Network Hatası Çözümü

// ❌ YANLIŞ - Docker içinden localhost çalışmaz
mongodb://localhost:27017/mydb

// ✅ DOĞRU - Service adını kullan
mongodb://mongo:27017/mydb

// Host makineden bağlanıyorsanız
mongodb://localhost:27017/mydb  // Bu çalışır

1. MongoDB Atlas Dashboard'a git
2. Network Access'e tıkla
3. IP Address ekle
4. "Add Current IP Address" veya 0.0.0.0/0 (development için)

// Atlas connection string formatı
mongodb+srv://username:password@cluster0.xxxxx.mongodb.net/mydb?retryWrites=true&w=majority

// Node.js örneği
mongoose.connect(process.env.MONGODB_URI, {
  useNewUrlParser: true,
  useUnifiedTopology: true,
  retryWrites: true
});