Laravel向MongoDB插入数据出现prepare()调用及模型类型错误问询

报错根本原因 #

• 两个报错的核心诱因都是MongoDB模型继承错误：你当前的Banner模型继承的是Laravel默认的关系型数据库Eloquent基类Illuminate\Database\Eloquent\Model，而非MongoDB扩展要求的专用基类。
• 第一个报错Call to a member function prepare() on null：默认Eloquent基类会调用关系型数据库的预处理SQL方法，MongoDB不支持SQL，所以方法调用为空触发报错。
• 第二个类型错误：你的MongoDBBaseRepository要求getModel返回Jenssegers\Mongodb\Eloquent\Model类型实例，Banner模型继承错误自然不符合类型约束。

具体解决步骤 #

1. 前置依赖确认 #

首先确保已安装Laravel MongoDB专用扩展jenssegers/laravel-mongodb：
执行命令：composer require jenssegers/mongodb
然后配置数据库连接：打开config/database.php，在connections数组中新增MongoDB连接配置：

'mongodb' => [
    'driver' => 'mongodb',
    'host' => env('MONGO_DB_HOST', '127.0.0.1'),
    'port' => env('MONGO_DB_PORT', 27017),
    'database' => env('MONGO_DB_DATABASE', 'your_db_name'),
    'username' => env('MONGO_DB_USERNAME', ''),
    'password' => env('MONGO_DB_PASSWORD', ''),
    'options' => [
        // 若MongoDB开启权限认证，需指定认证库：'database' => 'admin'
    ],
],

对应在.env文件中添加你的MongoDB连接参数即可。

2. 修正Banner模型继承关系 #

将Banner.php中的基类引入替换为MongoDB专用基类，修正后完整代码如下：

<?php

namespace App\Models\Mongo;

// 替换原有的Illuminate基类
use Jenssegers\Mongodb\Eloquent\Model;

class Banner extends Model
{
    protected $connection = 'mongodb';
    protected $collection = 'banner';
    protected $guarded = ['_id'];
    public $timestamps = false;
    protected $fillable = [
        '_id',
        'url',
        'width',
        'height',
    ];
}

3. 可选优化 #

_id字段无需手动传入new ObjectId()，扩展会在新增数据时自动生成MongoDB格式的主键，你可以直接删除create方法中的'_id' => new ObjectId()行。

验证效果 #

修改完成后：

1. 原直接调用Banner::create的写法可以正常运行，不会再触发prepare()报错
2. Repository模式的写法也会自动匹配类型约束，第二个类型错误同步解决

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