How to Fix Network Timeout Errors in MongoDB Connections

A network timeout in MongoDB usually happens when the client cannot connect to the server within the set time. To fix it, increase the connectTimeoutMS and socketTimeoutMS settings in your connection string or driver options, and ensure your network is stable and the server is reachable.

Why This Happens

A network timeout error occurs when your MongoDB client tries to connect to the server but does not get a response in time. This can happen because the server is down, the network is slow or unstable, or the timeout settings are too low.

javascript

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

const uri = 'mongodb://localhost:27017';
const client = new MongoClient(uri, { connectTimeoutMS: 1000, socketTimeoutMS: 1000 });

async function run() {
  try {
    await client.connect();
    console.log('Connected successfully');
  } catch (err) {
    console.error('Connection error:', err.message);
  } finally {
    await client.close();
  }
}

run();

Output

Connection error: Server selection timed out after 1000 ms

The Fix

Increase the connectTimeoutMS and socketTimeoutMS values to give the client more time to connect and communicate with the server. Also, verify the server address and network are correct and stable.

javascript

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

const uri = 'mongodb://localhost:27017';
const client = new MongoClient(uri, { connectTimeoutMS: 30000, socketTimeoutMS: 30000 });

async function run() {
  try {
    await client.connect();
    console.log('Connected successfully');
  } catch (err) {
    console.error('Connection error:', err.message);
  } finally {
    await client.close();
  }
}

run();

Output

Connected successfully

Prevention

To avoid network timeout errors in the future, always set reasonable timeout values based on your network speed and server response times. Monitor your MongoDB server health and network stability regularly. Use retry logic in your application to handle temporary network issues gracefully.

Related Errors

Other common connection errors include Server selection timeout, which means the client cannot find a suitable server, and Authentication failed, which happens when login credentials are wrong. Fix these by checking server availability and credentials.

Key Takeaways

Increase connectTimeoutMS and socketTimeoutMS to allow more time for connections.

Ensure your MongoDB server is running and reachable on the network.

Check network stability and avoid slow or unreliable connections.

Use retry logic in your application to handle temporary network issues.

Verify connection strings and credentials are correct.