Laravel 11中HasMiddleware的middleware()方法与Controller方法冲突

问题原因 #

父类Illuminate\Routing\Controller自带一个非静态的middleware()方法，而HasMiddleware接口要求实现静态的同名方法，PHP不允许子类将非静态方法重写为静态方法，因此触发错误：Cannot make non static method Illuminate\Routing\Controller::middleware() static in class App\Http\Controllers\BaseController。

解决方案 #

方案1：升级Laravel版本 #

将Laravel升级到v10.10.0及以上版本，该版本的Controller类已原生实现HasMiddleware接口，同时兼容静态与非静态的middleware()方法，原有代码无需修改即可正常运行。

方案2：改用构造函数注册中间件（无需升级） #

如果无法升级版本，放弃使用HasMiddleware接口，在BaseController的构造函数中通过父类的非静态middleware()方法注册中间件，代码示例：

<?php

namespace App\Http\Controllers;

use Illuminate\Routing\Controller;

class BaseController extends Controller
{
    public static $readPermission = null;

    public static $customPermissionChecks = [];

    public function __construct()
    {
        // 注册API认证中间件
        $this->middleware('auth:api');
        
        // 注册只读权限验证中间件
        if (static::$readPermission) {
            $this->middleware('permission:' . static::$readPermission, ['only' => ['index', 'show']]);
            // 注册读写权限验证中间件
            $this->middleware('permission:write.' . static::$readPermission, ['only' => ['edit', 'store', 'update', 'destroy', 'restore']]);
        }
        
        // 注册自定义权限检查中间件
        foreach (static::$customPermissionChecks as $middleware) {
            $this->middleware($middleware);
        }
    }
}

该方案保留了原有的权限验证逻辑，同时避免了方法名冲突问题。

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