Laravel自定义路由绑定覆盖问题：多参数时仅保留最后绑定的修复

问题背景 #

通过中间件API实现自定义路由绑定替代Eloquent直接查询时，遇到多参数场景下仅能保留最后一个绑定结果的问题：每次调用syncBinding方法时，$this->items会被直接赋值为当前参数的绑定结果，覆盖之前的所有值。

原代码问题分析 #

原代码中$this->items被设计为存储单个绑定结果的变量，且self::$bindable仅按绑定器类名标记是否已绑定，导致多个同类型参数的绑定请求只会处理第一个，后续参数的绑定逻辑被提前return阻断，同时即使执行也会覆盖$items的值。

修复方案 #

1. 调整存储结构 #

将$items改为数组类型，通过参数名作为键来区分不同参数的绑定结果，避免覆盖。

2. 修改绑定逻辑 #

遍历所有路由参数，筛选出当前绑定器对应的参数并逐个处理，同时调整self::$bindable的标记规则，避免类级别的绑定阻断多参数处理。

修改后的代码 #

首先调整类中$items的定义：

// 原单个结果改为数组存储多参数结果
protected $items = [];

然后修改syncBinding方法：

public function syncBinding(): void
{
    $routeBinding = Request::getRouteResolver()->call($this);
    $parameters = $routeBinding->parameters();
    $bindingFields = $routeBinding->bindingFields();

    $bindKey = mb_strtolower(class_basename($this));

    // 遍历所有路由参数，处理当前绑定器对应的所有参数
    foreach ($parameters as $paramName => $paramValue) {
        // 匹配当前绑定器对应的参数名（或绑定字段映射）
        if ($paramName !== $bindKey && (!isset($bindingFields[$bindKey]) || $bindingFields[$bindKey] !== $paramName)) {
            continue;
        }

        // 避免重复绑定同一参数
        $bindIdentifier = $bindKey . '_' . $paramName;
        if (array_key_exists($bindIdentifier, self::$bindable)) {
            continue;
        }

        $column = $bindingFields[$bindKey] ?? null;
        // 按参数名存储绑定结果
        $this->items[$paramName] = $this->resolveBinding($this, $paramValue, $column);
        
        // 按"绑定器类名_参数名"标记已绑定，避免类级别阻断多参数
        self::$bindable[$bindIdentifier] = true;
    }
}

关键修改说明 #

• 数组存储：$items改为数组后，每个参数的绑定结果以参数名为键独立存储，不会互相覆盖。
• 多参数遍历处理：不再仅处理单个参数，而是遍历所有路由参数，匹配当前绑定器对应的参数逐个绑定。
• 绑定标记细化：将self::$bindable的标记键从类名改为绑定器类名_参数名，确保每个参数的绑定状态独立，不会因单个类的绑定标记阻断后续参数处理。

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