JSON 转 Mongoose Schema

即时从 JSON 生成 Mongoose Schema,支持 JavaScript 和 TypeScript 输出、timestamps 选项、嵌套对象和数组。免费,在浏览器中运行。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
设置模型和根 schema 的名称。留空时使用 User。建议使用 User、Order 等简单名称。
语言 JavaScript 使用 CommonJS require 和 module.exports;TypeScript 使用 import/export,并将文档接口传给 Schema 和 model。
timestamps 开启时为根 schema 添加 timestamps: true。TypeScript 还会补充 Date 类型的 createdAt 和 updatedAt;JSON 已有同名键时保留原类型。
必填字段 开启时为基本类型、日期、Mixed 和基本类型数组字段添加 required: true。嵌套 schema 和对象数组保持原形式。
用含嵌套对象和数组的用户文档替换 JSON,并按当前模型名称及选项立即生成。
清空 JSON、输出和状态,保留模型名称及选项。在工具内按 Ctrl/⌘+L 还会清空模型名称。
输入合法 JSON。修改输入或模型名称后等待 300 毫秒生成,三个选项组会立即更新。JSON 无效时清空输出并禁用复制。
Mongoose Schema 输出
复制显示的完整 schema 和 model 导出语句。输出为空时禁用复制。

输入 JSON 或载入示例以生成 Mongoose schema。

示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

类型映射

  • 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、模型名称和选项与上一次记录时相同时不再记录。