Laravel9仅在中间件获取请求控制器方法名getActionName报null解决

报错核心原因 #

你遇到的Call to a member function getActionName() on null错误，本质是中间件执行时机不对：全局中间件运行时框架还没完成路由匹配解析，Route::getCurrentRoute()此时返回空值，自然调用不了对应方法。

正确实现方案 #

第一步：调整中间件注册位置 #

• 不要把该中间件注册在app/Http/Kernel.php的$middleware全局中间件数组中
• 要注册到$middlewareGroups下对应路由类型的分组里（比如web路由放到web组、api路由放到api组），且放在分组中间件列表的靠后位置，保证路由已经完成解析。如果是给单个/组路由单独绑定的中间件，不存在该时机问题。

第二步：使用兼容写法获取控制器与方法名 #

优先从请求实例中获取路由对象，增加空值判断避免报错，参考代码如下：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class CheckIt
{
    public function handle(Request $request, Closure $next)
    {
        $route = $request->route();
        if ($route) {
            // 获取完整的「控制器类@方法名」字符串
            $fullAction = $route->getActionName();
            
            // 拆分获取不含命名空间的控制器名、对应方法名
            $controllerBasename = class_basename($route->getController());
            [$controllerName, $methodName] = explode('@', $controllerBasename);

            // 针对你配置的/debug路由，最终获取值为：
            // $controllerName = "DebugController"
            // $methodName = "getDebug"
        }

        return $next($request);
    }
}

特殊场景适配 #

如果你必须将中间件注册为全局中间件、无法调整注册位置，就把获取路由信息的逻辑放到$next($request)执行之后，此时响应阶段路由已经完成解析，不会出现空值问题：

public function handle(Request $request, Closure $next)
{
    // 先放行请求，走到路由解析、控制器执行流程
    $response = $next($request);
    
    // 响应阶段再提取路由、控制器信息
    $route = $request->route();
    if ($route) {
        $fullAction = $route->getActionName();
        // 自定义业务逻辑
    }

    return $response;
}

注意：Laravel各版本中间件执行顺序、路由解析时机存在差异，不要直接照搬低版本Laravel的示例代码，在未确认路由已解析的情况下直接调用路由方法，很容易触发空对象报错。

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