JSON 转 Mongoose Schema
即时从 JSON 生成 Mongoose Schema,支持 JavaScript 和 TypeScript 输出、timestamps 选项、嵌套对象和数组。免费,在浏览器中运行。
- 在浏览器中处理
- 工具不会把输入上传到 ZeroTool 服务器
- 免费 · 无需注册
用微信扫描以下二维码即可分享
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。
类型映射
null不参与类型推断;所有样例都是null的字段 →mongoose.Schema.Types.Mixed- 各样例类型不同的字段(数字和字符串、对象和字符串)→
mongoose.Schema.Types.Mixed;ISO 日期时间与其他字符串混在一起 →String - 以 ISO 8601 日期时间开头的字符串(
2026-10-01T09:30:00Z)→Date;只有日期的2026-10-01、用空格代替T的2026-10-01 09:30:00,以及数组里的日期时间都保持String - 字符串 →
String - 数字 →
Number - 布尔值 →
Boolean - 基本类型数组 →
[String]/[Number]/[Boolean] - 对象数组 →
[subSchema](生成独立子 schema) - 嵌套对象 → 独立 schema 变量,内联引用
示例
给定如下 JSON,模型名称为 User:
{"username": "alice", "age": 28, "tags": ["admin"], "address": {"city": "London"}}
JavaScript 输出(timestamps 开启):
const mongoose = require('mongoose');
const { Schema } = mongoose;
const addressSchema = new Schema({
city: { type: String },
});
const userSchema = new Schema({
username: { type: String },
age: { type: Number },
tags: [String],
address: addressSchema,
}, { timestamps: true });
module.exports = mongoose.model('User', userSchema);
示例:每个样例都参与类型推断
根数组含两条订单,模型名称为 Order,JavaScript,timestamps 关闭:
[{"code":1,"note":null,"seller":{"meta":{"x":1}},"buyer":{"meta":{"y":"2"}}},{"code":"A-2","note":"gift","tags":["a",1]}]
输出:
const mongoose = require('mongoose');
const { Schema } = mongoose;
const metaSchema = new Schema({
x: { type: Number },
});
const sellerSchema = new Schema({
meta: metaSchema,
});
const buyerMetaSchema = new Schema({
y: { type: String },
});
const buyerSchema = new Schema({
meta: buyerMetaSchema,
});
const orderSchema = new Schema({
code: { type: mongoose.Schema.Types.Mixed },
note: { type: String },
seller: sellerSchema,
buyer: buyerSchema,
tags: [mongoose.Schema.Types.Mixed],
}, { timestamps: false });
module.exports = mongoose.model('Order', orderSchema);
code一条是1、另一条是"A-2",所以是Mixed;写成Number会拒绝"A-2"。note一条是null、一条是"gift",所以是String。tags里有字符串也有数字,元素为Mixed。- 两个
meta对象字段不同,第二个用父级 key 作前缀(buyerMetaSchema)。同一个 key 下字段和类型都相同的对象共用一个 schema;加前缀后仍重名时再加数字。
工具的测试用 Mongoose 9.10.3 运行生成的 JavaScript,用每个样例创建文档,确认 validateSync() 通过、所有字段和值都保留(ISO 日期时间以 Date 保存,按 toISOString() 形式比较;样例里没有的数组字段会得到 Mongoose 的默认值 [])。
中文键名与 MySQL 导出的时间
从 MySQL 导出后交给 Node.js 服务的订单数据,键名常用中文,时间列是 DATETIME。MySQL 8.4 手册写明 DATETIME 按 'YYYY-MM-DD hh:mm:ss' 格式读取和显示(The DATE, DATETIME, and TIMESTAMP Types)。下面这条订单里,下单时间是这种格式,支付时间是带 +08:00 的 ISO 8601(模型名称 order,JavaScript,timestamps 开启):
{"订单号":"A202610080001","下单时间":"2026-10-08 09:30:00","支付时间":"2026-10-08T09:31:05+08:00","金额":59.9,"收货地址":{"省":"浙江省","市":"杭州市"},"发票":{"抬头":"杭州示例科技有限公司"}}
输出:
const mongoose = require('mongoose');
const { Schema } = mongoose;
const fieldSchema = new Schema({
"省": { type: String },
"市": { type: String },
});
const orderFieldSchema = new Schema({
"抬头": { type: String },
});
const orderSchema = new Schema({
"订单号": { type: String },
"下单时间": { type: String },
"支付时间": { type: Date },
"金额": { type: Number },
"收货地址": fieldSchema,
"发票": orderFieldSchema,
}, { timestamps: true });
module.exports = mongoose.model('Order', orderSchema);
- 中文键名原样保留为字段路径,并加上引号,生成的文件可以直接运行。变量名只用 ASCII,所以
收货地址的子 schema 叫fieldSchema;发票的字段不同,加上模型名作前缀,成为orderFieldSchema。提交代码前,建议改成addressSchema、invoiceSchema这样能看懂的名字。 下单时间中间是空格而不是T,所以识别为String,查询时按字符串比较。支付时间识别为Date。MongoDB 的日期只记录一个时间点,不保存时区(Mongoose:Working With Dates),所以存进去后读出来是2026-10-08T01:31:05.000Z,要显示北京时间需在展示时再换算。金额是Number,也就是双精度浮点数。Mongoose 另有Decimal128类型(SchemaTypes),需要精确到分的金额时,可以改用它,或者改存以分为单位的整数。
限制
- Mixed 什么都收。因样例类型不一致而成为
Mixed的字段,不做类型转换和校验;修改它内部的值后要调用markModified(),Mongoose 才会保存。数据允许时,请统一成一种类型。 - 只认一种日期写法。字符串必须以
YYYY-MM-DDThh:mm:ss开头才会成为Date,上面的空格写法和只有日期的值都保持String。 - 根数组只看对象。schema 描述的是文档,根数组里与对象并列的数字、字符串、null 和数组不写进 schema,状态行会写明跳过了几个、各是什么 JSON 类型,例如
根数组中有 5 个值不是对象,未写进 schema(number × 2, string, null, array)。全是基本类型时不生成 schema,只输出注释// Array of primitives — no schema to generate。 - 保留路径名仍会保留,但会警告。Mongoose 9.10.3 把
collection,emit,errors,get,init,isModified,isNew,listeners,populated,remove,removeListener,save,toObject,validate列为保留名(lib/schema.js 中的Schema.reserved)。这些键仍是路径、值也会保存,但 Mongoose 会打印警告;在文档上,字段值会取代同名的方法或属性(errors、isNew是属性):有名为save的字段时,doc.save是这个值,doc.save()会出错。状态行会列出这些键;get、toObject还会弄坏文档,所以列在下一组。schema 选项suppressReservedKeysWarning只是不显示警告,所以工具不加它;请改键名。 - 其他文档成员名也可能弄坏文档。Mongoose 只对保留名发出警告,但文档上的成员不止这些。工具按 Mongoose 9.10.3 文档的成员检查每个键,在状态行列出两组。第一组是 Mongoose 自己会用到的文档成员(方法或属性),用作字段名可能导致创建、校验或序列化文档时出错,状态行会改用警告色:有名为
markModified的字段时,new Model()抛出this.markModified is not a function;_doc会导致Maximum call stack size exceeded;schema在输入只有 schema 里的键时正常,一旦出现其他键就报Cannot read properties of undefined (reading 'discriminatorKey');toJSON会让JSON.stringify(doc)输出 Mongoose 的内部状态($__、_doc)。这一组是_doc、__index、__parentArray、get、isDirectModified、markModified、modifiedPaths、schema、toBSON、toJSON、toObject、validateSync,以及 29 个以$开头的名称(get、toObject同时也是保留名)。另外 83 个名称 Mongoose 不会警告,字段值只是取代同名的方法或属性:有名为model和set的字段时,doc.model、doc.set就是字段值。工具的测试用真实的 Mongoose 9.10.3 文档重新得出这两组名称。请修改这些键名。 - 三个键名不会成为路径。Mongoose 9.10.3 建 schema 时跳过名为
__proto__、constructor、prototype的键(lib/schema.js,为防止原型污染)。输出里仍保留这些键,__proto__写成["__proto__"],避免对象字面量把它当成原型;状态行会列出它们,保存这类数据前请改键名。 - 不生成 ObjectId、enum、索引和校验。24 位十六进制字符串仍是
String;Schema.Types.ObjectId与ref、unique、enum、min/max需要自己补。 - TypeScript 只给根 schema 加类型参数。子 schema 的
new Schema()没有类型参数;必填字段关闭时接口里的字段也不带?。Mongoose 不检查接口与 schema 是否一致,可选字段请自己加?。
FAQ
这个工具生成什么?
从 JSON 生成 Mongoose schema 定义。嵌套对象生成子 schema,写在使用它的 schema 之前(同一个 key 下字段和类型都相同的对象共用一个),底部包含 model 导出语句。
支持哪些语言模式?
JavaScript(CommonJS require/module.exports)和 TypeScript(ES module import/export)。TypeScript 输出按 Mongoose TypeScript 指南的写法,生成普通的文档接口并传给 Schema<T> 与 model<T>,不继承 Document。
JSON 类型如何映射到 Mongoose 类型?
string→String,以 ISO 8601 日期时间开头的字符串(如 2026-10-01T09:30:00Z)→Date;number→Number;boolean→Boolean;所有样例都为 null 或各样例类型不同的字段→mongoose.Schema.Types.Mixed;基本类型数组→[Type](数组里的日期时间仍是 String);不含 null 元素的对象数组→[子 schema];嵌套对象→子 schema。
timestamps 选项有什么作用?
开启时,schema 会以 { timestamps: true } 创建,Mongoose 将自动管理 createdAt 和 updatedAt 字段(类型为 Date)。TypeScript 模式下接口也会列出 createdAt: Date 与 updatedAt: Date;JSON 根对象已有同名键时保留它自己的类型。
所有字段都会标记为必填吗?
默认不会。仅凭 JSON 样例无法判断哪些字段必填。打开「必填字段」后,除嵌套 schema 和对象数组外的所有字段都会加上 required: true,再把可选字段的 required 删掉即可。注意 Mongoose 的 required 校验不接受 null,样例里为 null 的字段不能保留 required。
我的数据会发送到服务器吗?
不会。JSON 和模型名称只在当前浏览器标签页里处理,不会发送出去,工具也不把它们存进浏览器存储。页面只在你改完输入并移开焦点、点击示例或切换选项时记录一条统计事件,内容只有工具名和动作(generate);JSON、模型名称和选项与上一次记录时相同时不再记录。