Mongoose是MongoDB在Node.js环境中最受欢迎的ODM（对象文档映射）库，它在原生驱动之上封装了一层Schema建模能力，让开发者可以用面向对象的方式操作数据库。相比于直接使用mongodb原生驱动，Mongoose提供了数据校验、中间件钩子、类型转换和关联查询等实用特性，大幅提升了开发效率和代码可维护性。本文将从连接配置、Schema设计到常见的增删改查实践，完整讲解Mongoose的使用方法。
一、为什么选择Mongoose而不是原生驱动
MongoDB本身是无模式数据库，理论上可以直接用原生驱动插入任意结构的文档。但这种自由在团队协作中往往变成隐患：不同开发者写入的字段类型可能不一致，日期可能存成字符串，金额可能存成字符串数字，后期排查数据问题非常痛苦。
Mongoose的核心价值就是通过Schema给集合加上一层结构约束。定义Schema后，每个字段都有明确的类型声明，写入前会自动做类型转换和校验，不合法的数据会在保存阶段直接抛出错误，而不是脏数据悄悄入库。此外，Mongoose内置的populate方法可以模拟关系型数据库的关联查询，让多集合关联的数据获取变得非常简洁。
当然，Mongoose也有代价：它对查询结果做了大量包装，返回的是Document对象而不是普通对象，在极致性能场景下会有一定开销。但对于绝大多数业务系统来说，这点开销换来的是开发效率的大幅提升，是完全值得的。
二、安装与连接数据库
首先在项目中安装Mongoose，它会自动携带mongodb原生驱动作为依赖：
npm install mongoose
连接数据库使用connect方法，推荐始终添加useNewUrlParser和useUnifiedTopology相关的现代配置。连接成功后可以通过事件监听来观察连接状态：
const mongoose = require('mongoose');
mongoose.connect('mongodb://127.0.0.1:27017/myapp', {
useNewUrlParser: true,
useUnifiedTopology: true
});
const db = mongoose.connection;
db.on('error', console.error.bind(console, '连接失败:'));
db.once('open', function() {
console.log('数据库连接成功');
});需要注意的是，Mongoose默认使用单个连接，其内部维护了一个大小为100的连接池（通过poolSize配置）。在高并发场景下，如果发现连接数不足，可以在连接字符串后面追加参数调整：mongodb://127.0.0.1:27017/myapp?poolSize=50。另外，新版Mongoose已经支持异步方式建立连接：
mongoose.connect('mongodb://127.0.0.1:27017/myapp').then(() => {
console.log('连接成功');
}).catch(err => {
console.error('连接失败', err);
});三、定义Schema与创建模型
Schema是Mongoose的核心概念，它描述集合中文档的结构、字段类型、默认值、校验规则等。先定义Schema，再通过mongoose.model把它编译成Model，Model对应MongoDB中的集合，所有数据库操作都通过Model完成。
const mongoose = require('mongoose');
const { Schema } = mongoose;
const userSchema = new Schema({
username: {
type: String,
required: [true, '用户名不能为空'],
unique: true,
trim: true
},
email: {
type: String,
required: true,
lowercase: true,
match: [/^\S+@\S+\.\S+$/, '邮箱格式不正确']
},
age: {
type: Number,
min: [0, '年龄不能为负数'],
max: 150
},
role: {
type: String,
enum: ['admin', 'user'],
default: 'user'
},
createdAt: {
type: Date,
default: Date.now
}
});
const User = mongoose.model('User', userSchema);
module.exports = User;Schema支持丰富的校验规则，例如required必填校验、min和max数值范围校验、enum枚举校验、match正则校验等。字符串类型还支持trim自动去除首尾空格、lowercase自动转小写等转换器，这些都会在校验之前自动执行，非常实用。
一个常见的问题是unique字段。这里的unique并不是Mongoose层面的校验，而是会在MongoDB中创建唯一索引，因此违反唯一约束时报错发生在数据库层面，错误类型与普通ValidationError不同，处理时需要单独判断err.code === 11000。
四、增删改查常用操作
Mongoose的CRUD API设计得非常直观。创建文档使用create或先实例化再save：
// 方式一：create直接创建
const user = await User.create({
username: 'zhangsan',
email: 'zhangsan@ipipp.com',
age: 25
});
// 方式二：实例化后保存
const doc = new User({ username: 'lisi', email: 'lisi@ipipp.com' });
await doc.save();查询操作中，find返回数组，findOne返回单条文档，findById按主键查询。链式调用sort、limit、skip可以轻松实现分页：
// 分页查询：第2页，每页10条，按创建时间倒序
const users = await User.find({ role: 'user' })
.sort({ createdAt: -1 })
.skip(10)
.limit(10)
.select('username email age');
// 统计总数用于计算总页数
const total = await User.countDocuments({ role: 'user' });更新和删除分别推荐使用updateOne、updateMany、deleteOne、deleteMany。要特别注意：默认情况下这些方法的更新不会触发Schema校验，如果希望更新时也执行校验，需要加上runValidators: true选项：
await User.updateOne(
{ username: 'zhangsan' },
{ age: 30 },
{ runValidators: true }
);
await User.deleteOne({ username: 'lisi' });五、关联查询与中间件
当集合之间存在引用关系时，可以在Schema中使用ref声明关联，然后用populate一次性取出关联数据，避免手动多次查询。例如文章集合引用用户集合：
const articleSchema = new Schema({
title: String,
content: String,
author: { type: Schema.Types.ObjectId, ref: 'User' }
});
const Article = mongoose.model('Article', articleSchema);
// 查询文章并填充作者信息
const articles = await Article.find()
.populate('author', 'username email');
console.log(articles[0].author.username);Mongoose还支持中间件机制，可以在文档保存、删除等操作前后执行自定义逻辑，常用于密码加密、数据清理等场景：
userSchema.pre('save', async function(next) {
// 只在密码字段被修改时才重新加密
if (!this.isModified('password')) return next();
this.password = await bcrypt.hash(this.password, 10);
next();
});
userSchema.post('remove', function(doc) {
console.log('用户已被删除:', doc.username);
});六、常见问题与注意事项
第一个常见的坑是查询结果无法直接修改或序列化的问题。Mongoose查询返回的是Document对象，它带有许多内部属性，直接JSON.stringify会附带不必要的字段，直接修改字段也受跟踪机制影响。解决方法是调用lean()让查询返回普通JavaScript对象，特别适合只需要读取展示的场景：
const users = await User.find().lean();
第二个需要注意的点是查询结果为空的处理。findOne查不到数据时返回null而不是抛出异常，很多新手直接访问其属性导致空指针错误，使用前务必判空。
第三点是全局插件与Schema复用。当多个Schema都需要相同的字段（如createdAt、updatedAt）时，可以使用插件机制复用逻辑。Mongoose内置的timestamps选项就等价于一个全局插件，只需在Schema配置中开启{ timestamps: true }，就会自动维护这两个时间字段。
掌握这些核心内容后，你就能够在Node.js项目中用Mongoose构建出结构清晰、校验完善的数据层。建议从Schema设计入手，先把数据模型规划好，再编写业务逻辑，这样整个开发过程会顺畅很多。