Laravel Eloquent模型枚举转换如何允许Null值？

针对你遇到的数据库origin字段为Null时，枚举转换导致查询失败的问题，除了新增枚举项外，还有以下两种可行方案：

方案一：自定义支持Null的枚举转换类 #

创建一个继承自Laravel默认EnumCast的自定义转换类，专门处理值为Null的场景：

<?php

namespace App\Casts;

use Illuminate\Database\Eloquent\Casts\EnumCast;

class NullableEnumCast extends EnumCast
{
    public function get($model, string $key, $value, array $attributes)
    {
        // 若字段值为Null，直接返回Null，跳过枚举转换
        if (is_null($value)) {
            return null;
        }

        return parent::get($model, $key, $value, $attributes);
    }

    public function set($model, string $key, $value, array $attributes)
    {
        // 若设置的值为Null，直接存入数据库，无需转换
        if (is_null($value)) {
            return null;
        }

        return parent::set($model, $key, $value, $attributes);
    }
}

然后在模型的$casts属性中，将origin字段的转换类替换为这个自定义类，并指定对应的枚举类型（用:分隔）：

protected $casts = [
   'status' => MemberStatusEnum::class,
   'documentType' => DocumentationTypeEnum::class,
   'origin' => NullableEnumCast::class.':'.MemberOriginEnum::class,
   'gender' => GenderEnum::class
];

方案二：在模型中重写getAttribute方法单独处理 #

如果仅需针对origin单个字段处理，可直接在模型中重写获取属性的方法：

public function getAttribute($key)
{
    $value = parent::getAttribute($key);

    // 针对origin字段，值为Null时直接返回，不进行枚举转换
    if ($key === 'origin' && is_null($value)) {
        return null;
    }

    return $value;
}

注意事项 #

确保数据库中的origin字段已通过迁移设置为允许Null：

$table->string('origin')->nullable();

内容的提问来源于stack exchange，提问作者Elena Martín Castillo