Sửa lỗi MongoParseError "useNewUrlParser is not supported" trong Next.js App Router

Khi phát triển ứng dụng Next.js App Router kết nối với MongoDB, bạn có thể gặp lỗi "MongoParseError: option useNewUrlParser is not supported". Nguyên nhân là các tùy chọn cũ này đã bị loại bỏ trong phiên bản driver mới, nhưng vẫn được dùng trong các bài hướng dẫn cũ. Bài viết này sẽ giải thích nguyên nhân và cung cấp giải pháp đơn giản là xóa bỏ các tùy chọn không cần thiết để kết nối hoạt động bình thường.

Khi xây dựng dự án Next.js App Router kết nối với MongoDB, tôi đã gặp lỗi này:

<div class="highlight js-code-highlight"> <pre class="highlight plaintext"><code>MongoParseError: option useNewUrlParser is not supported </code></pre> </div>

Ban đầu có vẻ khó hiểu, đặc biệt nếu bạn đang theo các tutorial cũ. Dưới đây là giải thích đơn giản về vấn đề và cách khắc phục.

❌ Vấn đề

Nếu bạn đang dùng đoạn mã sau:

<div class="highlight js-code-highlight"> <pre class="highlight javascript"><code>const options = { useNewUrlParser: true, useUnifiedTopology: true, };

const client = new MongoClient(uri, options); </code></pre>

</div>

👉 Bạn sẽ gặp lỗi:

<div class="highlight js-code-highlight"> <pre class="highlight plaintext"><code>MongoParseError: option useNewUrlParser is not supported </code></pre> </div>

🧠 Tại sao lại xảy ra

Lỗi này xảy ra vì:

MongoDB cũ (trước 2021) sử dụng các tùy chọn này.
Trong MongoDB Node.js Driver phiên bản 4 trở lên, các tùy chọn này đã bị xóa bỏ và bật mặc định bên trong.

Do đó, việc truyền chúng thủ công bây giờ sẽ làm hỏng kết nối.

✅ Giải pháp (Đơn giản)

Chỉ cần xóa hoàn toàn các tùy chọn.

✔️ Mã đúng

<div class="highlight js-code-highlight"> <pre class="highlight javascript"><code>const client = new MongoClient(uri); </code></pre> </div>

Đó là tất cả. Không cần cấu hình thêm.

📁 Ví dụ đầy đủ (lib/mongodb.js)

Dưới đây là ví dụ hoàn chỉnh mà bạn có thể sử dụng:

<div class="highlight js-code-highlight"> <pre class="highlight javascript"><code>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; </code></pre> </div>

⚠️ Kiểm tra quan trọng

Trước khi chạy ứng dụng, hãy đảm bảo:

<code>.env.local</code> được cấu hình đúng cú pháp:
<div class="highlight js-code-highlight"> <pre class="highlight properties"><code>MONGODB_URI=your_mongodb_connection_string </code></pre> </div>
Khởi động lại server phát triển:
<div class="highlight js-code-highlight"> <pre class="highlight console"><code>npm run dev </code></pre> </div>

💡 Mẹo bổ sung

Không nên tin tưởng mù quáng vào các bài hướng dẫn hoặc tài liệu cũ. Luôn kiểm tra phiên bản package.
Dùng lệnh sau để xác minh phiên bản driver MongoDB:
<div class="highlight js-code-highlight"> <pre class="highlight console"><code>npm list mongodb </code></pre> </div>
Nếu bạn đang sử dụng Next.js App Router, hãy đảm bảo API routes được đặt trong thư mục:
<div class="highlight js-code-highlight"> <pre class="highlight plaintext"><code>app/api/your-route/route.js </code></pre> </div>

🎯 Kết luận

Lỗi này xảy ra vì MongoDB đã loại bỏ các tùy chọn cũ như <code>useNewUrlParser</code>, và các driver hiện đại xử lý mọi thứ tự động.

👉 Vậy giải pháp đơn giản là:

Xóa các tùy chọn cũ.

Sử dụng <code>new MongoClient(uri)</code> trực tiếp.

Nếu bài viết này giúp ích cho bạn, hãy chia sẻ nó với những người đang gặp vấn đề tương tự 🚀