Typegoose更新含数组字段的嵌套文档报preferredTags类型转换错误

两个配置错误导致Typegoose未正确识别子文档字段类型：

• 类声明顺序错误：代码中先定义父类DocSchema，后定义子文档类form1SubDoc。JS类不存在变量提升，父类的@prop装饰器执行时，form1SubDoc还是undefined，Typegoose无法加载子文档的schema规则，最终把preferredTags错误识别为单值String类型，而非String[]数组，触发数组强转字符串的校验错误。
• 嵌套子文档配置不规范：直接给type传类引用的写法没有做惰性加载，进一步放大了类加载顺序的问题。

你碰到的「不传preferredTags就能写入成功」的现象也符合这个错误逻辑：name、gender、age都是单值，就算被误识别为Mixed混合类型也能临时存入，碰到数组类型时才触发类型不匹配报错。

1. 调整类声明顺序，优先定义子文档类，再定义父文档类
2. 嵌套子文档的@prop配置用箭头函数惰性传入子文档类，这是Typegoose官方推荐写法，可彻底规避类加载顺序、循环引用导致的schema解析失败
3. 类型定义统一用原始类型小写string/number，不要用JS包装类String/Number，避免不必要的类型兼容问题

Schema定义部分：

import { prop, getModelForClass } from '@typegoose/typegoose';
import mongoose from 'mongoose';

// 子文档类优先定义
class form1SubDoc {
  _id?: mongoose.Types.ObjectId;

  @prop({ type: String, required: true })
  public name!: string;
 
  @prop({ type: String })
  public gender?: string;

  @prop({ type: Number })
  public age?: number;

  @prop({ type: [String] })
  public preferredTags?: string[];
}

// 后定义父文档类
class DocSchema {
  @prop({ type: String })
  public identifier?: string;

  // 用箭头函数惰性加载子文档类
  @prop({ type: () => form1SubDoc })
  public form1SubDoc?: form1SubDoc;
}

const MainDoc = getModelForClass(DocSchema);
export default MainDoc;

原有更新逻辑不需要改动，schema配置正确后，Mongoose会自动把传入的普通JS对象转换为合规的子文档实例，按正确类型校验存储：

const form1Pointer = await MainDoc.findOne({/* 你的查询逻辑 */});
if(form1Pointer) {
   form1Pointer.form1SubDoc = 前端传入的对象;
   await form1Pointer.save();
}

补充：如果碰到极个别旧版本Mongoose不自动转换子文档的情况，可以手动构造子文档实例再赋值：form1Pointer.form1SubDoc = new form1SubDoc(前端传入的对象)

内容的提问来源于stack exchange，提问作者canaryGrapher