怎么在Mongoose中定义MongoDB的Schema_数据类型限制与默认值设置

夜瑶大大_7055

夜瑶大大_7055

2026-04-10

396人浏览

原创

字符串字段需在字段定义中设 required: true 和 maxlength;日期默认值用 Date.now(不带括号);数组字段须声明 type: [String] 并设 default: [];自定义 validator 仅在 save/validate 时生效,update 需 runValidators: true。

怎么在mongoose中定义mongodb的schema_数据类型限制与默认值设置

Schema 中怎么写字符串长度限制和必填校验

字符串字段的 required 和 maxlength 必须写在字段定义对象里,不是挂在 Schema 构造函数上。漏掉 required: true 会导致空字符串或 null 被静默接受;只写 maxlength 不加 validate 或原生约束,MongoDB 层不会拦截超长内容——Mongoose 只在 save 前校验。

常见错误现象:save() 成功但数据库存了 200 字符的 title,而你期望最多 50 字。

  • required: true 是布尔值,不是字符串 "true"
  • maxlength 对中文也按字符数算(不是字节数),一个汉字 = 1
  • 如果还要支持正则校验(比如邮箱格式),得额外加 validate 函数,maxlength 不管格式
const userSchema = new mongoose.Schema({
  name: { type: String, required: true, maxlength: 50 },
  email: { 
    type: String, 
    required: true,
    validate: [/^\S+@\S+\.\S+$/, '邮箱格式不合法'] 
  }
});

日期类型怎么设默认值才可靠

用 Date.now(不带括号)设默认值,而不是 new Date()。后者在 Schema 定义时就执行一次,所有文档共享同一个时间戳;前者每次新建文档时才调用,拿到实时时间。

使用场景:创建时间(createdAt)、最后更新时间(updatedAt)这类字段。

  • default: Date.now ✅ 每次实例化都重新取当前时间
  • default: new Date() ❌ Schema 编译时就固定了,所有 doc 都一样
  • 如果想自动更新 updatedAt,得配合 timestamps: true 或中间件,单靠 default 不行
const postSchema = new mongoose.Schema({
  title: String,
  createdAt: { type: Date, default: Date.now }, // 注意没有 ()
  updatedAt: { type: Date, default: Date.now }
}, { timestamps: true }); // 这个会自动管理 updatedAt

数组字段的类型声明和默认空数组陷阱

数组字段必须显式声明 type: Array 并用 items(或旧写法 of)指定元素类型,否则 Mongoose 不会校验数组内容,甚至允许 push 任意类型进去。

容易踩的坑:写成 tags: [String] 看似简洁,但 Mongoose 5.10+ 会警告并推荐用 { type: [String] };更关键的是,如果没设 default,该字段在 document 中是 undefined,不是空数组——导致 doc.tags.push() 直接报错。

  • 安全写法:tags: { type: [String], default: [] }
  • 嵌套对象数组要写全:comments: { type: [{ author: String, text: String }], default: [] }
  • required: true 对数组意味着“不能是 undefined 或 null”,但允许空数组 []

自定义 validator 和异步校验的边界在哪

Mongoose 的 validate 支持同步函数和返回 Promise 的异步函数,但仅限于 save() 和 validate() 调用时触发。它不会在 updateOne、findOneAndUpdate 等直接操作中运行——这些命令绕过 Mongoose 文档中间层,校验直接失效。

性能影响明显:异步 validator(比如查数据库去重)会让 save() 变慢,且无法并发控制;一旦出错,整个 save 中断,但事务里其他操作已提交的部分不会回滚。

  • 唯一性校验别只靠 validate,必须加 MongoDB 唯一索引(unique: true)兜底
  • 异步 validator 返回 Promise,拒绝时传 Error 实例,Mongoose 才能捕获为校验错误
  • update 操作想跑校验,得用 runValidators: true 选项,且只对 $set 等部分修改生效
username: {
  type: String,
  validate: {
    validator: async function(v) {
      const count = await this.constructor.countDocuments({ username: v });
      return count === 0;
    },
    message: '用户名已被占用'
  }
}

Mongoose 的校验逻辑只活在 document 实例的生命周期里,脱离这个上下文(比如 bulkWrite、aggregate、原生 driver 操作),所有 schema 约束都形同虚设。真正起作用的永远是 MongoDB 自身的索引和 validator,Mongoose 只是第一道软关卡。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

875

5

mongodb启动命令
mongodb启动命令

MongoDB 是一种开源的、基于文档的 NoSQL 数据库管理系统。本专题提供mongodb启动命令的文章,希望可以帮到大家。

2023.08.08

3254

5

MongoDB删除数据的方法
MongoDB删除数据的方法

MongoDB删除数据的方法有删除集合中的文档、删除整个集合、删除数据库和删除指定字段等。本专题为大家提供MongoDB相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.19

3104

5

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4809

19

mongodb有哪些应用领域
mongodb有哪些应用领域

mongodb 的应用领域涵盖广泛,包括内容管理系统、社交媒体、分析、移动应用、物联网、金融科技、医疗保健和广告技术等领域,因其灵活性、可扩展性和易用性而广受欢迎。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

978

6

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

8392

6

mongodb安装失败如何彻底删除
mongodb安装失败如何彻底删除

彻底删除 mongodb 安装失败的步骤:1、停止和禁用 mongodb 服务;2、删除配置文件、数据目录和日志文件;3、删除 mongodb 二进制文件;4、卸载 mongodb 套件(如果通过软件包管理器安装);5、删除 mongodb 用户、组和目录;6、重启系统。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

595

6

mongodb与mysql好用推荐
mongodb与mysql好用推荐

mongodb 适用于非结构化数据、高扩展性和灵活查询(如网站内容管理、社交媒体),而 mysql 适用于结构化数据、强数据一致性和联接查询(如电子商务、银行系统)。

2024.04.02

2529

9

mongodb数据库的优势有哪些
mongodb数据库的优势有哪些

mongodb 数据库以其灵活、可扩展和高性能而闻名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2831

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习