Laravel 12 MorphTo多态关联遇未知类型值的处理方案咨询

问题场景 #

我在Laravel 12中实现多态关联功能，Balance模型代码如下：

class Balance
{
    public $subject;
    public $subject_id;
    
    public function subjectable(): MorphTo
    {
        return $this->morphTo(__FUNCTION__, 'subject', 'subject_id');
    }
}

同时在AppServiceProvider中配置了类型映射：

Relation::morphMap([
    'shop' => 'App\Models\Shop',
    'merchant' => 'App\Models\Merchant',
]);

由于数据库是外部不可控资源，当subject字段出现不在映射列表中的值（比如'abc'）时，会抛出「Class "abc" not found」错误，导致morphTo()无法正常工作。需求是：设置允许的类型白名单，当subject不在列表中时，关联返回null或空集合。

尝试过的无效方案 #

曾尝试在关联方法内检查$this->subject，但加载关联时该字段值为null，无法生效：

public function subjectable() {
    var_dump($this->subject);
    if (in_array($this->subject, ['shop', 'merchant'])) {
        return $this->morphTo(__FUNCTION__, 'subject', 'subject_id');
    }
    return null;
}

测试代码：

$result = $query->with(['subjectable'])->get(); // $this->subject is null
// or
$result = $query->get(); 
$result->load(['subjectable']); // $this->subject is null

可行解决方案 #

方案1：自定义关联解析逻辑 #

在subjectable关联方法中，利用resolveUsing回调手动处理类型校验，非法类型直接返回null：

use Illuminate\Database\Eloquent\Relations\MorphTo;
use Illuminate\Database\Eloquent\Relation;

public function subjectable(): MorphTo
{
    return $this->morphTo(__FUNCTION__, 'subject', 'subject_id')
        ->resolveUsing(function ($type, $id) {
            $morphMap = Relation::morphMap();
            // 校验类型是否在白名单内
            if (!array_key_exists($type, $morphMap)) {
                return null;
            }
            // 合法类型则查询对应模型
            return $morphMap[$type]::find($id);
        });
}

方案2：查询阶段过滤合法类型 #

如果不需要保留含未知类型的Balance记录，可以在查询时直接过滤：

$validSubjects = array_keys(Relation::morphMap());
$result = Balance::whereIn('subject', $validSubjects)->with('subjectable')->get();

该方案适合只关注合法关联记录的场景，能从根源避免解析错误。

方案3：全局异常捕获（谨慎使用） #

在App\Exceptions\Handler中捕获类未找到的异常，判断是多态解析场景时返回null。但此方案是全局生效，可能影响其他业务逻辑，需谨慎测试：

public function register()
{
    $this->renderable(function (\Error $e, $request) {
        // 判断是否为多态类型解析异常
        if (str_starts_with($e->getMessage(), 'Class "') && str_ends_with($e->getMessage(), '" not found')) {
            $className = trim($e->getMessage(), 'Class "" not found');
            $morphMap = Relation::morphMap();
            if (!in_array($className, $morphMap)) {
                return null;
            }
        }
    });
}

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