本质是mongoose禁止覆盖已编译模型；最可靠判断方式是检查mongoose.models对象中是否存在对应键，存在则直接复用，否则才调用mongoose.model()注册。
直接检查 mongoose.models 是否已存在同名模型
报错 Cannot overwrite model once compiled 的本质，是 Mongoose 检测到你要用 mongoose.model('User', schema) 注册一个已存在的模型名。最轻量、最可控的判断方式就是查 mongoose.models 这个对象——它是个 plain object，键为模型名，值为编译后的 Model 构造函数。
实际使用时，不要每次都无脑调用 mongoose.model()，先做存在性判断：
- 如果
mongoose.models.User已存在，直接返回它 - 否则才用
mongoose.model('User', userSchema)创建并缓存 - 注意：不能只靠
typeof mongoose.model('User') === 'function'来判断，因为这会触发强制注册，反而引发错误
在模块导出时用 “缓存优先” 模式封装模型
常见错误是每个 router 或 service 文件都 require('./models/User')，而该文件内部又无条件执行 mongoose.model('User', ...)。正确做法是让模型文件自己负责“只注册一次”：
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 导出逻辑写成：
module.exports = mongoose.models.User || mongoose.model('User', userSchema) - 这样无论 require 多少次，都只会首次执行
mongoose.model()，后续全走缓存分支 - 避免在 Express 路由中间件、测试 setup、CLI 脚本里重复调用
mongoose.model() - 如果你用 ES modules，注意
import也会触发模块执行，所以同样要加mongoose.models.Xxx判断
热重载（如 nodemon）下模型被反复初始化怎么办
开发时 nodemon 重启进程，但旧的 mongoose 实例可能没完全销毁（尤其用了单例连接），导致新加载的模型文件再次尝试注册已存在的模型。这不是 bug，是预期行为。
- 解决方案一：在启动入口（如
app.js）中统一初始化所有模型，而不是分散在各 model 文件里 - 解决方案二：加一个清除逻辑（仅限开发）：
if (process.env.NODE_ENV === 'development') { delete mongoose.models.User; }，放在模型定义前 - 更稳妥的做法是把模型注册和连接解耦：连接建立后，再批量注册模型，且确保注册逻辑只运行一次（例如用
global.registeredModels = new Set()做标记）
unique: true 字段为空值导致 E11000 错误？别漏掉稀疏索引
这个错误常被误认为是模型重复定义，其实属于另一类高频问题：当你给字段设了 unique: true（比如 email: { type: String, unique: true }），但插入文档时该字段为 null 或缺失，MongoDB 会把 null 当作一个有效值存入唯一索引——而唯一索引只允许一个 null。
- 现象：
{"name":"MongoError","code":11000,"err":"... dup key: { : null }"} - 根本原因不是模型定义，而是 MongoDB 索引行为
- 修复方式：在 Schema 中显式启用稀疏索引：
email: { type: String, unique: true, sparse: true } - 已有集合需重建索引：
db.users.dropIndex("email_1"); db.users.createIndex({email: 1}, {unique: true, sparse: true})
mongoose.models 是全局共享的。哪怕你改了文件路径或 require 方式，只要模型名字符串相同（如 'user' 和 'User'），就视为同一个模型。多人协作时，务必约定命名规范并写进 ESLint 规则里。
