Laravel中laravel-mongodb关联模型存ObjectId的问题及合理性问询

一、正确存储userId为ObjectId并实现Eloquent正常检索 #

要解决关联键存储与检索的问题，核心是让Eloquent和laravel-mongodb包正确识别字段的ObjectId类型，以下是具体步骤：

1. 配置模型主键类型
   在User和Book模型中明确主键的类型，确保Eloquent以ObjectId处理主键：

// User.php
protected $primaryKey = '_id';
protected $keyType = 'objectid';
public $incrementing = false;

// Book.php
protected $primaryKey = '_id';
protected $keyType = 'objectid';
public $incrementing = false;

2. 设置字段类型转换
   在Book模型中通过$casts属性指定user_id为ObjectId类型，确保存入和取出时自动转换：

// Book.php
protected $casts = [
    'user_id' => 'objectid',
];

3. 正确定义关联关系
   关联定义时明确指定外键和关联主键，避免Eloquent自动推断错误：

// User.php 一对多关联
public function books()
{
    return $this->hasMany(Book::class, 'user_id', '_id');
}

// Book.php 反向关联
public function user()
{
    return $this->belongsTo(User::class, 'user_id', '_id');
}

4. 使用Eloquent关联方法保存数据
   通过模型关联方法保存时，Eloquent会自动将user_id转换为ObjectId存入，无需手动处理：

$user = User::find('60d21b4667d0d8992e610c85'); // 字符串ID会自动转为ObjectId
$book = new Book(['title' => 'Laravel MongoDB实战']);
$user->books()->save($book);

如果需要手动查询，确保查询条件的类型匹配：

// 正确：使用ObjectId类型查询
$books = Book::where('user_id', $user->_id)->get();

// 也支持字符串自动转换
$books = Book::where('user_id', '60d21b4667d0d8992e610c85')->get();

二、存储userId为ObjectId的实际意义 #

将外键存储为ObjectId而非字符串，主要有以下价值：

• 类型一致性：与MongoDB默认的_id类型保持统一，避免字符串与ObjectId混合导致的查询隐式转换，减少潜在的匹配错误。
• 性能优化：ObjectId以二进制格式存储，占用空间比字符串更小，对应的索引查找效率更高，在大数据量场景下优势明显。
• 原生操作兼容：直接使用MongoDB客户端或原生查询时，ObjectId类型的外键可直接执行关联查询，无需额外的类型转换操作。
• 数据规范：ObjectId自带唯一性和时间戳属性，统一使用该类型能提升数据结构的规范性，降低格式错误引发的问题。

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