MERN项目连接MongoDB报错：TypeError: Cannot read properties of undefined (reading 'collection')

这个错误本质是你调用collection()的对象是undefined——要么数据库没成功连接，要么你没正确获取到连接后的数据库实例。结合你的MERN项目场景，按以下步骤排查修复：

1. 检查数据库连接文件（conn.js） #

不管用mongoose还是原生MongoDB驱动，必须确保导出的是已成功连接的数据库实例，而非未完成的Promise或空对象。

用mongoose的正确写法： #

const mongoose = require('mongoose');

const connectDB = async () => {
  try {
    const conn = await mongoose.connect(process.env.MONGO_URI);
    console.log(`MongoDB已连接: ${conn.connection.host}`);
    // mongoose自动管理连接，路由直接用Model即可，无需手动传db
  } catch (err) {
    console.error(`连接失败: ${err.message}`);
    process.exit(1);
  }
};

module.exports = connectDB;

用原生MongoDB驱动的正确写法： #

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

const connectDB = async () => {
  try {
    const client = await MongoClient.connect(process.env.MONGO_URI);
    db = client.db('你的数据库名'); // 明确指定要操作的数据库
    console.log(`MongoDB已连接，当前数据库: ${db.databaseName}`);
  } catch (err) {
    console.error(`连接失败: ${err.message}`);
    process.exit(1);
  }
};

// 导出已连接的db实例
module.exports = { connectDB, getDB: () => db };

2. 修正server.js的初始化顺序 #

必须先完成数据库连接，再启动服务器、挂载路由，避免路由访问时db还未初始化：

require('dotenv').config({ path: './config.env' });
const express = require('express');
const { connectDB, getDB } = require('./conn.js'); // 对应原生驱动的导出
const booksRouter = require('./book.js');

const app = express();

// 先连数据库，再启动服务
connectDB().then(() => {
  // 原生驱动需把db挂载到请求对象，供路由使用
  app.use('/books', (req, res, next) => {
    req.db = getDB();
    next();
  }, booksRouter);

  app.listen(5000, () => {
    console.log('服务器启动在5000端口');
  });
});

3. 调整book.js路由的collection调用 #

原生驱动场景： #

确保使用的是已连接的db实例，不能直接用未初始化的变量：

const express = require('express');
const router = express.Router();

router.get('/', async (req, res) => {
  try {
    // 从请求对象中获取挂载的db实例
    const books = await req.db.collection('books').find({}).toArray();
    res.json(books);
  } catch (err) {
    res.status(500).json({ msg: err.message });
  }
});

module.exports = router;

mongoose场景： #

无需手动调用collection，直接用Model操作：

// 先定义bookModel.js
const mongoose = require('mongoose');
const bookSchema = new mongoose.Schema({
  title: String,
  author: String,
  // 其他字段
});

module.exports = mongoose.model('Book', bookSchema);

然后在book.js路由中使用：

const express = require('express');
const Book = require('./bookModel.js');
const router = express.Router();

router.get('/', async (req, res) => {
  try {
    const books = await Book.find();
    res.json(books);
  } catch (err) {
    res.status(500).json({ msg: err.message });
  }
});

module.exports = router;

4. 验证config.env的连接字符串 #

确保MONGO_URI格式正确：

• 本地MongoDB：MONGO_URI=mongodb://localhost:27017/你的数据库名
• Atlas远程：MONGO_URI=mongodb+srv://<用户名>:<密码>@集群地址/你的数据库名?retryWrites=true&w=majority
  同时确认已安装对应依赖：npm install mongoose或npm install mongodb

5. 加日志确认连接状态 #

在conn.js中添加详细日志，启动服务器后查看控制台——如果未输出“已连接”的日志，说明连接本身失败，需先解决基础连接问题（比如MongoDB服务未启动、连接字符串密码错误等）。

内容的提问来源于stack exchange，提问作者Roman Nichi