当向 Mongoose 的 ObjectId 类型字段（如 author）传入字符串时，若未显式转换为合法 ObjectId 实例，将触发 Cast 错误；正确做法是使用 mongoose.Types.ObjectId() 安全转换并校验有效性。
当向 mongoose 的 objectid 类型字段（如 `author`）传入字符串时，若未显式转换为合法 objectid 实例，将触发 cast 错误；正确做法是使用 `mongoose.types.objectid()` 安全转换并校验有效性。
在使用 Mongoose 构建 Node.js 或 Next.js 应用时，常通过 ref 建立文档间引用关系（例如 author: { type: mongoose.Schema.Types.ObjectId, ref: 'User' }）。但需注意：Mongoose 不会自动将任意字符串安全解析为 ObjectId——它仅在字符串格式合法（24位十六进制）时尝试转换；若格式错误（如空值、短ID、含非十六进制字符），便会抛出 Cast to ObjectId failed... because of "BSONError"。
因此，在调用 Text.create() 之前，必须确保 author 参数已转换为有效的 ObjectId 实例：
import { Types } from 'mongoose';
// ✅ 正确：显式转换 + 校验（推荐）
if (!Types.ObjectId.isValid(author)) {
throw new Error('Invalid author ID: must be a 24-character hex string');
}
const createdText = await Text.create({
text,
author: new Types.ObjectId(author), // ← 关键：强制转换为 ObjectId 实例
community: null,
path,
});
⚠️ 注意事项：
- 不要依赖隐式转换：即使字符串看起来像 ObjectId（如 "65a1b2c3d4e5f67890123456"），直接传入仍可能因验证时机问题失败；
- 务必前置校验：Types.ObjectId.isValid() 是轻量级格式检查（不查数据库），应在转换前调用，避免 BSONError 泄露敏感信息；
- 处理边界情况：若 author 可能为 null、undefined 或空字符串，需单独判断，否则 new Types.ObjectId(undefined) 会生成无效 ID；
- 类型安全建议（TypeScript）：将参数 author: string 显式约束，并在服务层立即转为 Types.ObjectId，避免跨层传递原始字符串。
最后，更新用户文档时也应保持一致性：
await User.findByIdAndUpdate(
new Types.ObjectId(author), // 同样需要转换
{ $push: { text: createdText._id } }
);
总结：Mongoose 的 ObjectId 字段不是“字符串友好型”类型。所有外部输入（尤其是 API 请求体中的 ID 字符串）都必须经过 Types.ObjectId.isValid() 校验 + new Types.ObjectId() 实例化，才能安全用于查询或写入操作。 这既是避免运行时错误的关键步骤，也是保障数据完整性的基本实践。
