升级 laravel 后中间件不生效,通常是因为 app/http/kernel.php 中的 $middlewaregroups 或 $routemiddleware 配置未正确合并、路由定义中未应用中间件别名,或者自定义中间件的 handle 方法逻辑中断了请求。排查时请检查 kernel 文件是否保留了旧版中间件注册,确认路由是否绑定了正确的中间件组,并验证中间件类的命名空间与类名是否匹配。

如何检查 Kernel 中的中间件注册状态
直接回答:检查 app/Http/Kernel.php 确保所有需要的中间件都在 $middlewareGroups 和 $routeMiddleware 数组中正确注册。在 Laravel 5.4+ 版本中,全局中间件位于 $middleware 属性,而路由组中间件位于 $middlewareGroups。如果升级后某些中间件失效,往往是因为它们被错误地放在了已废弃的全局列表,或者在新版的 $routeMiddleware 中缺失了别名映射。你需要对比升级前的配置文件,确保没有遗漏任何新增的框架默认中间件(如 throttle 或 bindings),同时确认自定义中间件已添加到相应的组中。

namespace App\Http;
use Illuminate\Foundation\Http\Kernel as HttpKernel;
class Kernel extends HttpKernel
{
protected $middleware = [
\Illuminate\Foundation\Http\Middleware\HandlePrecognitiveRequests::class,
\Illuminate\Http\Middleware\TrustProxies::class,
\Fruitcake\Cors\HandleCors::class,
\App\Http\Middleware\PreventRequestsDuringMaintenance::class,
\Illuminate\Http\Middleware\ValidatePostSize::class,
\App\Http\Middleware\TrimStrings::class,
\Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
];
protected $middlewareGroups = [
'web' => [
\App\Http\Middleware\EncryptCookies::class,
\Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
\Illuminate\Session\Middleware\StartSession::class,
\Illuminate\View\Middleware\ShareErrorsFromSession::class,
\App\Http\Middleware\VerifyCsrfToken::class,
\Illuminate\Routing\Middleware\SubstituteBindings::class,
],
'api' => [
\Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,
'throttle:api',
\Illuminate\Routing\Middleware\SubstituteBindings::class,
],
];
protected $routeMiddleware = [
'auth' => \App\Http\Middleware\Authenticate::class,
'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
'can' => \Illuminate\Auth\Middleware\Authorize::class,
'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,
'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
];
}
运行 php artisan route:list 查看路由是否加载了预期的中间件。如果列表中显示为空或错误,说明 Kernel 配置未正确加载。确保 composer dump-autoload 已执行以刷新类映射。
如何验证路由定义中的中间件绑定
直接回答:在路由文件中显式使用 ->middleware() 或 middleware() 数组来绑定中间件,避免依赖隐式的组继承。Laravel 8+ 引入了新的路由定义语法,如果使用闭包路由,必须确保中间件作为第二个参数传入或使用链式调用。对于控制器路由,需在 RouteServiceProvider 或路由文件中使用 middleware() 方法指定组。如果升级后中间件不生效,检查路由定义是否使用了过期的 before 或 after 钩子,这些在 Laravel 5.3+ 已被移除。应改用标准的中间件管道机制。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。

// routes/web.php
use Illuminate\Support\Facades\Route;
use App\Http\Controllers\TestController;
// 方式一:使用 middleware 数组
Route::get('/test', [TestController::class, 'index'])
->middleware(['auth', 'custom.middleware']);
// 方式二:使用 group 包裹
Route::middleware(['auth'])->group(function () {
Route::get('/profile', [TestController::class, 'profile']);
});
// 方式三:闭包路由
Route::get('/closure-test', function () {
return 'Hello';
})->middleware('auth');
如果使用的是 API 路由,确保 routes/api.php 中的路由也应用了正确的中间件组。在 Laravel 9+ 中,API 路由默认不再自动应用 web 中间件组,需手动添加 session 或 cookie 相关中间件如果需要会话支持。通过 php artisan route:list --json 可以详细查看每个路由的中间件栈,确认目标路由是否包含你期望的中间件类。
当中间件 handle 方法返回 null 时会发生什么
直接回答:如果自定义中间件的 handle 方法没有返回 $next($request) 的结果,而是返回 null 或其他非响应对象,Laravel 将抛出 Type Error 或返回空响应,导致前端看似“无反应”或报错。中间件的核心职责是处理请求并传递到下一个环节,因此必须在方法末尾返回 $next($request)。如果需要在中间件中终止请求,应返回一个 Response 对象,如 return response()->json(['error' => 'Unauthorized'], 401);。检查你的中间件代码,确保没有意外地吞掉了返回值。
namespace App\Http\Middleware;
use Closure;
use Illuminate\Http\Request;
class CustomMiddleware
{
public function handle(Request $request, Closure $next)
{
// 业务逻辑...
// 错误示例:忘记返回 $next($request)
// return null;
// 正确示例:继续管道
return $next($request);
}
}
在调试时,可以在 handle 方法开头添加 Log::info('Middleware executed'); 来确认中间件是否被调用。如果日志中有记录但页面空白,重点检查返回值类型。确保中间件类实现了 HandleMiddleware 接口(Laravel 10+ 推荐)或至少符合 PSR-15 标准,以便框架能正确识别和处理它。

















