Laravel 9.x 中间件中自定义Request类绑定不生效问题

你的写法失效有两个核心原因：

• 绑定配置写错了：代码里的Request::class没有引入对应命名空间，默认解析为全局根命名空间下的Request类，和框架实际用的Illuminate\Http\Request不是同一个类，绑定从一开始就没生效。
• 就算绑定写对了也没用：Laravel运行中间件栈（Pipeline管道）时，是直接把启动阶段就实例化好的Illuminate\Http\Request对象透传给每个中间件的handle方法，不会走服务容器的依赖解析流程去替换参数实例。而且Request是提前生成的单例，普通的类名绑定只会在新建实例时生效，根本覆盖不了已经存在的现成对象。

方案1：中间件内手动转换实例（无侵入，推荐） #

不需要修改任何全局绑定，把中间件handle方法的第一个参数类型改回框架原生的Illuminate\Http\Request，在方法内部手动转换为自定义请求实例即可：

public function handle(\Illuminate\Http\Request $request, Closure $next)
{
    /** @var MyRequest $myRequest */
    $myRequest = MyRequest::createFromBase($request);
    
    // 后续业务逻辑直接使用$myRequest即可
    // ...
}

这个方案兼容性最好，不会影响框架其他部分的正常运行。

方案2：全局替换请求实例（全场景生效） #

如果需要全项目所有地方都用MyRequest替代原生Request，不要用$bindings数组做类绑定，要在服务提供者里直接绑定已经生成的自定义实例，覆盖容器里原有的request单例：

1. 先在AppServiceProvider文件顶部引入正确的类：

use Illuminate\Http\Request;
use LaravelCommon\Http\Request\MyRequest;

2. 在register方法中添加实例绑定逻辑：

public function register()
{
    // 基于现有原生请求实例生成自定义请求实例
    $myRequest = MyRequest::createFromBase($this->app->make('request'));
    // 绑定自定义实例到容器，覆盖原有request单例
    $this->app->instance('request', $myRequest);
    // 绑定类名别名，保证两类的类型提示都能正常解析
    $this->app->alias('request', Request::class);
    $this->app->alias('request', MyRequest::class);
}

完成上述配置后，中间件handle方法直接声明MyRequest类型参数就不会再报类型错误，所有从容器获取Request的场景都会返回MyRequest实例。

方案3：中间件内替换透传的请求实例 #

如果只需要在当前中间件及后续执行链路中使用自定义请求，可以在中间件里生成实例后直接传递给$next，同时更新容器内的绑定：

public function handle(\Illuminate\Http\Request $request, Closure $next)
{
    $myRequest = MyRequest::createFromBase($request);
    $this->app->instance('request', $myRequest);
    return $next($myRequest);
}

避坑提示：Request类的实例替换必须使用instance方法绑定现成对象，不能用普通的类名绑定。所有框架提前实例化的核心类（比如Request、Application）都不能靠$bindings数组的配置替换，因为这些对象在服务提供者启动前就已经生成，普通绑定不会覆盖已有实例。

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