讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夜瑶大大_7055

夜瑶大大_7055

发布时间:2026-04-10 02:11:17

|

396人浏览过

|

来源于php中文网

原创

字符串字段需在字段定义中设 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 只是第一道软关卡。

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

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

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

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

875

2023.07.18

mongodb启动命令
mongodb启动命令

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

3254

2023.08.08

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

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

3104

2023.09.19

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

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

4809

2023.11.02

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

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

978

2024.04.02

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

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

8372

2024.04.02

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

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

595

2024.04.02

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

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

2509

2024.04.02

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn