求助：Mongoose代码为何出现CastError转换错误？

你的模型定义没问题，问题出在服务器代码的请求体解析环节，导致传入Mongoose的relations值是字符串而非预期的对象结构。

先看核心报错：

Error: CastError: Cast to [ObjectId] failed for value "[\n { contact: new ObjectId(ID_OF_CONTACT_STRING), title: 'test' }\n]" (type string) at path "relations.0" because of "CastError"

这个报错明确说明：Mongoose收到的relations字段是一个字符串格式的对象内容，而非真正的JS对象，所以无法将其中的contact字段转换成ObjectId类型。

问题根源 #

虽然你代码里手动构造了newRelation对象，但大概率是后端没有正确解析JSON请求体：

• 前端发送请求时，没有设置Content-Type: application/json头，导致后端拿到的是表单格式或字符串化的内容
• 后端框架（比如Next.js API路由）的JSON解析配置异常，req.body没有被转换成JS对象，仍是原始字符串

修复方案 #

1. 先排查请求体解析是否正常

在代码最开头加日志，确认req.body的类型和内容：

console.log('req.body类型:', typeof req.body);
console.log('req.body内容:', req.body);

如果输出类型是string，说明请求体没被解析成JSON，需要：

• 前端调整请求，确保设置Content-Type: application/json，并以JSON格式发送数据
• 后端检查是否启用了JSON解析中间件（比如Express的express.json()，Next.js默认支持，但自定义配置可能冲突）

2. 显式确保ObjectId类型（可选保险）

即使relation._id是ObjectId，也可以显式转换避免潜在类型问题：

import mongoose from 'mongoose';

// ...
const newRelation = { 
  contact: mongoose.Types.ObjectId(relation._id), 
  title: req.body.relationTitle 
};

3. 简化更新操作（可选）

改用findByIdAndUpdate替代updateOne，写法更简洁，减少出错点：

await Contact.findByIdAndUpdate(
  req.body.contactId,
  { $push: { relations: newRelation } },
  { new: true } // 可选，返回更新后的文档
);

模型定义验证 #

你的relations字段定义完全正确，符合Mongoose嵌套数组的规范，不需要修改：

const ContactSchema = new Schema(
  {
    ...
    relations: [{
      contact: {
        type: Schema.Types.ObjectId,
        ref: 'Contact'
      },
      title: String
    }],
    ...
  },
  {
    timestamps: true
  }
);

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