Laravel纯（非带值）Enum字段数据库搜索异常问题求助

问题核心：Laravel默认的Enum字段转换仅支持带有底层类型的Backed Enum，对于无底层类型的Unit Enum（比如你定义的Enum1），框架无法自动将Enum实例转换为数据库存储的字符串（通常是枚举case的name值），因此查询时会抛出类型转换错误。

最简单的解决方案：自定义Enum转换类 #

通过实现自定义的Eloquent Cast类，统一处理Unit Enum的读写和查询转换逻辑，无需手动调用->name。

1. 创建自定义转换类
   在app/Casts目录下新建UnitEnumCast.php（目录不存在则自行创建）：

<?php

namespace App\Casts;

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
use Illuminate\Database\Eloquent\Model;

class UnitEnumCast implements CastsAttributes
{
    protected string $enumClass;

    // 接收枚举类名作为初始化参数
    public function __construct(string $enumClass)
    {
        $this->enumClass = $enumClass;
    }

    // 从数据库读取时，将字符串转为对应Enum实例
    public function get($model, string $key, $value, array $attributes)
    {
        if (is_null($value)) {
            return null;
        }

        return $this->enumClass::from($value);
    }

    // 写入数据库时，将Enum实例转为name字符串
    public function set($model, string $key, $value, array $attributes)
    {
        if ($value instanceof \UnitEnum) {
            return $value->name;
        }

        return $value;
    }

    // 关键逻辑：查询绑定参数时自动将Enum实例转为字符串
    public function serialize($model, string $key, $value, array $attributes)
    {
        return $value instanceof \UnitEnum ? $value->name : $value;
    }
}

2. 在Model中配置自定义转换
   替换原来的Enum cast配置，指定使用自定义转换类并传入目标枚举类名：

use App\Casts\UnitEnumCast;
use App\Enums\Enum1;

class YourModel extends Model
{
    protected $casts = [
        // 格式：自定义转换类名:枚举类名
        'enum1' => UnitEnumCast::class . ':' . Enum1::class,
        // 带底层类型的Enum可继续使用默认转换逻辑
        'enum2' => Enum2::class,
    ];
}

3. 测试查询
   现在可以直接用Enum实例执行查询，无需额外处理：

YourModel::query()->where('enum1', Enum1::Case1)->first();

原理说明 #

自定义转换类的serialize方法会在Laravel处理查询绑定参数时被触发，自动将Unit Enum实例转换为对应的name字符串；同时get和set方法保证了数据读写过程中的类型转换，完全满足通过配置字段转换解决问题的需求。

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