While building a Next.js App Router project with MongoDB, I ran into this error:
MongoParseError: option useNewUrlParser is not supported
At first, it looks confusing—especially if you're following older tutorials. Here's a simple breakdown of what’s happening and how to fix it.
❌ The Problem
If you're using code like this:
const options = {
useNewUrlParser: true,
useUnifiedTopology: true,
};
const client = new MongoClient(uri, options);
👉 You’ll get the error:
MongoParseError: option useNewUrlParser is not supported
🧠 Why This Happens
This error occurs because:
Older MongoDB (pre-2021) used these options
In MongoDB Node.js Driver v4+, these options were:
- ❌ Removed
- ✅ Enabled by default internally
So now, passing them manually actually breaks the connection
✅ The Fix (Simple)
Just remove the options completely.
✔️ Correct Code
const client = new MongoClient(uri);
That’s it. No extra config needed.
📁 Full Working Example (lib/mongodb.js)
import { MongoClient } from 'mongodb';
const uri = process.env.MONGODB_URI;
let client;
let clientPromise;
if (!process.env.MONGODB_URI) {
throw new Error('Add Mongo URI to .env.local');
}
if (process.env.NODE_ENV === 'development') {
if (!global._mongoClientPromise) {
client = new MongoClient(uri);
global._mongoClientPromise = client.connect();
}
clientPromise = global._mongoClientPromise;
} else {
client = new MongoClient(uri);
clientPromise = client.connect();
}
export default clientPromise;
⚠️ Important Checks
Before running your app, make sure:
• .env.local is correct
MONGODB_URI=your_mongodb_connection_string
• Restart your dev server
npm run dev
💡 Extra Tips
Don’t blindly follow old tutorials or outdated documentations—always check package versions
Use:
npm list mongodb
to verify your MongoDB driver version
If you're using Next.js App Router, keep your API routes inside:
app/api/your-route/route.js
🎯 Conclusion
The error happens because MongoDB removed legacy options like useNewUrlParser, and modern drivers handle everything automatically.
👉 So the fix is simply:
Remove outdated options
Use new MongoClient(uri) directly
If this helped you, feel free to share it with others who might be stuck on the same issue 🚀
#nextjs #mongodb #webdev #javascript #beginners #backend