MERN+Apollo环境下addQuote mutation返回cameras子文档为null的问题

1. Mongoose模型字段定义不匹配 #

检查Quote模型里cameras的子文档结构，必须和传入的bodies、lenses字段名完全一致，类型也要匹配。比如模型里如果写成body而非bodies，或者把数组类型定义成了对象，都会导致MongoDB无法正确存储数据，最终返回null。

错误示例：

const QuoteSchema = new mongoose.Schema({
  cameras: [{
    body: String, // 字段名与传入的bodies不匹配
    lens: String  // 字段名与传入的lenses不匹配
  }]
});

修正后：

const QuoteSchema = new mongoose.Schema({
  cameras: [{
    bodies: String,
    lenses: String
  }]
});

2. GraphQL TypeDefs字段映射错误 #

确认GraphQL的Quote类型中，cameras的子字段要和模型、请求变量的字段名完全对齐。如果TypeDefs里的字段名和模型不一致，Apollo无法正确解析返回数据，子文档就会显示null。

错误示例：

type Camera {
  body: String
  lens: String
}

type Quote {
  id: ID!
  cameras: [Camera]
}

修正后：

type Camera {
  bodies: String
  lenses: String
}

type Quote {
  id: ID!
  cameras: [Camera]
}

3. Resolver未正确返回子文档数据 #

检查addQuote resolver的逻辑，必须等待Mongoose的save操作完成后再返回数据，且不能遗漏cameras字段。如果未等待异步操作完成就返回，或者手动过滤了cameras，都会导致子文档无法正确读取。

错误示例：

const resolvers = {
  Mutation: {
    addQuote: async (_, { input }) => {
      const quote = new Quote(input);
      quote.save(); // 未等待异步保存完成
      return quote; // 此时quote的cameras可能还未写入
    }
  }
};

修正后：

const resolvers = {
  Mutation: {
    addQuote: async (_, { input }) => {
      const quote = new Quote(input);
      await quote.save(); // 等待保存完成确保数据写入
      return quote;
    }
  }
};

4. 请求变量字段与定义不匹配 #

确认Apollo Sandbox中传入的mutation变量，字段名要和TypeDefs、模型完全一致。比如变量里写body而非bodies，会导致数据无法正确存入，返回时自然为null。

错误示例：

{
  "input": {
    "cameras": [
      {
        "body": "Canon R5",
        "lens": "24-70mm"
      }
    ]
  }
}

修正后：

{
  "input": {
    "cameras": [
      {
        "bodies": "Canon R5",
        "lenses": "24-70mm"
      }
    ]
  }
}

5. Mongoose子文档嵌套层级问题 #

如果cameras是更深层级的嵌套结构（比如cameras是对象，内部包含bodies数组），要确保模型和TypeDefs的嵌套层级完全匹配，否则会导致返回null。

模型定义示例：

const QuoteSchema = new mongoose.Schema({
  cameras: {
    bodies: [String],
    lenses: [String]
  }
});

对应TypeDefs：

type Camera {
  bodies: [String]
  lenses: [String]
}

type Quote {
  id: ID!
  cameras: Camera
}

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