release: v1.2.3 — fix model() using registry key as MongoDB collection name

Author: rockyshi1993

CHANGELOG.md

@@ -9,6 +9,7 @@
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.2.3](./changelogs/v1.2.3.md) | 2026-04-26 | 🐛 **Bug Fix**：`model()` 方法修复注册 key 直接作为 MongoDB 集合名的问题，优先读 `definition.collection > definition.name`，注册 key 仅作 fallback，向后兼容 | [查看](./changelogs/v1.2.3.md) |
 | [v1.2.2](./changelogs/v1.2.2.md) | 2026-04-24 | 🆕 **新功能**：Model 数据源绑定 — `connection: { pool?, database? }` 支持 Model 绑定指定连接池和/或数据库，四种组合路由，向后兼容；🐛 **Bug Fix**：修复 `Model._clear()` 导致 `msq.model()` 实例缓存失效失效，populate 关系丢失问题 | [查看](./changelogs/v1.2.2.md) |
 | [v1.2.1](./changelogs/v1.2.1.md) | 2026-04-13 | 🐛 **Bug 修复**：`msq.model()` 实例缓存 + 索引去重 + 死代码清理 + `types/monsqlize.ts` 补全 `model()` / `collection()` 类型 | [查看](./changelogs/v1.2.1.md) |
 | [v1.2.0](./changelogs/v1.2.0.md) | 2026-04-13 | 🐛 **Bug 修复 + 新功能**：`findPage` 正式支持 `projection` 投影参数（修复静默忽略问题）+ 有效投影策略自动保护游标排序字段 + 8 个测试用例 | [查看](./changelogs/v1.2.0.md) |

changelogs/v1.2.3.md

@@ -0,0 +1,46 @@
+# v1.2.3 — 2026-04-26
+
+> **类型**: 🐛 Bug Fix  
+> **影响范围**: `lib/index.js`（`model()` 方法）  
+> **向后兼容**: ✅ 完全兼容 — 对未使用目录路由注册 key 的场景行为不变
+
+---
+
+## Bug Fix：`model()` 方法使用注册 key 作为 MongoDB 集合名
+
+### 问题
+
+`model(collectionName)` 获取 collection 实例时，直接将传入的注册 key（`collectionName`）作为 MongoDB 集合名传给 `_resolveModelCollection` 和 `dbInstance.collection()`。
+
+当上层框架（如 vext）使用带路径前缀的注册 key（如 `AOrder`，由目录 `a/order.ts` 推断），而 `definition.name` 存储了实际 MongoDB 集合名（如 `order`）时，MongoDB 访问的集合名与预期不符。
+
+### 根因
+
+```js
+// v1.2.2 — 直接使用注册 key 作为集合名
+const collection = (connection && (connection.pool || connection.database))
+  ? this._resolveModelCollection(collectionName, connection)
+  : this.dbInstance.collection(collectionName);
+```
+
+### 修复
+
+在获取 collection 前，优先从 `definition.collection` 或 `definition.name` 读取实际集合名，注册 key 仅作为 fallback：
+
+```js
+// [v1.2.3] 实际 MongoDB 集合名可能不同于注册 key
+const actualCollectionName =
+  modelDef.definition.collection ||
+  modelDef.definition.name ||
+  collectionName;  // fallback：注册 key（向后兼容）
+
+const collection = (connection && (connection.pool || connection.database))
+  ? this._resolveModelCollection(actualCollectionName, connection)
+  : this.dbInstance.collection(actualCollectionName);
+```
+
+### 兼容性
+
+- 现有 model（注册 key 与 MongoDB 集合名相同，如直接传 `"admin_login_logs"`）：
+  `actualCollectionName = definition.collection || definition.name || "admin_login_logs"` — 行为完全不变 ✅
+- 新场景（框架注入 `definition.name` 实际集合名）：正确使用 `definition.name` ✅

lib/index.js

@@ -737,11 +737,18 @@ module.exports = class {
     // 获取 Model 定义
     const modelDef = Model.get(collectionName);
 
+    // [v1.2.3 patch] 实际 MongoDB 集合名可能不同于注册 key
+    // 优先读 definition.collection > definition.name > key（fallback，向后兼容）
+    const actualCollectionName =
+      modelDef.definition.collection ||
+      modelDef.definition.name ||
+      collectionName;
+
     // 获取 collection 实例（v1.2.2+ 支持 connection 路由）
     const connection = modelDef.definition.connection;
     const collection = (connection && (connection.pool || connection.database))
-      ? this._resolveModelCollection(collectionName, connection)
-      : this.dbInstance.collection(collectionName);
+      ? this._resolveModelCollection(actualCollectionName, connection)
+      : this.dbInstance.collection(actualCollectionName);
 
     // 创建 ModelInstance 并缓存
     const instance = new Model.ModelInstance(collection, modelDef.definition, this);

package.json

@@ -1,6 +1,6 @@
 {
   "name": "monsqlize",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "A lightweight MongoDB ORM with multi-level caching, transaction support, distributed features, Saga distributed transactions, unified expression system with 122 operators, and universal function caching (100% MongoDB support)",
   "main": "lib/index.js",
   "module": "index.mjs",