使用Laravel Excel与Medialibrary队列导入Excel时遇model_type字段错误

为啥会出这问题？ #

1. model_type无默认值报错：队列执行时，模型实例可能因序列化丢失关联信息，导致媒体库无法正确填充model_type字段；或者你还没把Product存入数据库就急着添加媒体，此时模型无ID和类型标识，存媒体时就会缺字段。
2. 关闭队列后图片存不上：addMediaFromUrl默认是异步下载逻辑，哪怕关闭了导入队列，媒体下载仍依赖队列执行；如果没强制同步下载，或者队列worker没运行，图片就无法保存。

直接按这几步改就行 #

1. 先存Product，再加媒体 #

导入时必须先把Product保存到数据库，拿到有效ID后再处理媒体，而且不用手动调用$media->save()，toMediaCollection()已经完成媒体记录的创建与关联：

public function model(array $row)
{
    // 先创建并保存产品模型
    $product = Product::create([
        'name' => $row['name'],
        // 补充你的其他必填字段
    ]);

    // 有图片URL才执行媒体添加
    if (!empty($row['image_url'])) {
        $product->addMediaFromUrl($row['image_url'])
            ->preservingOriginal()
            ->toMediaCollection(Product::MEDIA_COLLECTION);
    }

    return $product;
}

2. 队列中避免使用序列化模型 #

因为导入类实现了ShouldQueue，模型会被序列化传递，容易出问题。如果是在导入事件回调中处理媒体，记得用主键重新从数据库获取模型：

public function registerEvents(): array
{
    return [
        AfterImport::class => function (AfterImport $event) {
            foreach ($event->rows as $row) {
                // 用主键获取已保存的产品实例
                $product = Product::find($row['id']);
                if ($product && !empty($row['image_url'])) {
                    $product->addMediaFromUrl($row['image_url'])
                        ->preservingOriginal()
                        ->toMediaCollection(Product::MEDIA_COLLECTION);
                }
            }
        },
    ];
}

同时检查Product模型是否正确引入媒体库的Trait：

use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;

class Product extends Model implements HasMedia
{
    use InteractsWithMedia;

    // ...其他业务代码
}

3. 给model_type字段添加默认值（可选） #

如果数据库media表的model_type字段没有默认值，直接修改表结构：

ALTER TABLE media MODIFY COLUMN model_type VARCHAR(255) NULL DEFAULT NULL;

4. 关闭队列时强制同步下载图片 #

关闭导入队列后，需要给addMediaFromUrl加上download()方法，强制同步下载图片，避免依赖队列：

$product->addMediaFromUrl($row['image_url'])
    ->preservingOriginal()
    ->download() // 强制同步下载
    ->toMediaCollection(Product::MEDIA_COLLECTION);

5. 确保媒体库队列正常运行 #

不管开不开导入队列，媒体转换和下载都可能依赖队列，要保证队列worker在运行：

php artisan queue:work

如果媒体库配置了自定义队列，就指定队列名启动worker：

php artisan queue:work --queue=media-library,default

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