Lumen 5.8 启用CORS时出现middleware方法未定义报错如何解决

报错根因 #

你遇到的Call to undefined method Illuminate\Foundation\Application::middleware()错误，是因为误用了Laravel的全局中间件注册语法，Lumen 5.8 没有middleware()方法，全局中间件通过直接操作$app->middleware属性注册。

修复步骤 #

1. 修正中间件注册代码 #

修改bootstrap/app.php中的中间件注册逻辑，去掉方法调用的括号，改为属性赋值：

// 错误写法（Laravel语法）
// $app->middleware([
//    App\Http\Middleware\CorsMiddleware::class
// ]);

// 正确写法（Lumen 5.8 语法，追加中间件不覆盖原有配置）
$app->middleware[] = App\Http\Middleware\CorsMiddleware::class;

2. 调整服务提供者注册顺序 #

将CatchAllOptionsRequestsProvider的注册代码放在中间件配置之后，确保OPTIONS请求能被正确捕获：

// 先注册全局中间件
$app->middleware[] = App\Http\Middleware\CorsMiddleware::class;

// 再注册OPTIONS请求处理服务提供者
$app->register(App\Providers\CatchAllOptionsRequestsProvider::class);

3. 可选优化（解决跨域头丢失问题） #

如果修改后仍有跨域报错，可以调整CorsMiddleware的响应头设置逻辑，避免被后续逻辑覆盖：

public function handle($request, Closure $next)
{
    if($request->isMethod('OPTIONS')) {
        $response = response('', 200);
    } else {
        $response = $next($request);
    }

    // 一次性设置所有跨域头，优先级更高
    return $response->withHeaders([
        'Access-Control-Allow-Origin' => '*',
        'Access-Control-Allow-Methods' => 'HEAD, GET, POST, PUT, PATCH, DELETE',
        'Access-Control-Allow-Headers' => $request->header('Access-Control-Request-Headers') ?? 'Content-Type, X-Requested-With',
        // 若需要跨域携带Cookie，需删除上面的Origin=*，改为指定前端域名，再加上下面这行
        // 'Access-Control-Allow-Credentials' => 'true'
    ]);
}

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