中间件构造函数不能接收路由参数，参数只能通过handle()方法的$parameters数组传递；必须在路由中用冒号语法显式声明，如middleware:check.role:admin，且仅内联注册有效。
中间件构造函数不能直接接收路由参数
你写 app/Http/Middleware/CheckRole.php 时，如果在 __construct() 里加参数（比如 public function __construct($role)），Laravel 启动时就会报错：Target [string] is not instantiable。因为 Laravel 的中间件是容器解析的，不是按需实例化的——它不知道你那个 $role 是从哪来的。
真正能动态传值的地方，只有中间件的 handle() 方法，而且必须通过路由定义显式传递：
- 路由里用冒号语法写参数，比如
middleware:check.role:admin - 中间件类名后跟冒号 + 值，多个值用英文逗号分隔，如
check.role:admin,edit - 这些值会作为字符串，原样传进
handle()的第三个参数（即$parameters数组）
正确声明和解析中间件参数：handle() 的 $parameters 怎么用
handle() 方法签名固定为 handle($request, Closure $next, ...$parameters)，其中 ...$parameters 就是你从路由里传进来的值。它们永远是字符串数组，哪怕只传一个，也是 ['admin']，不是 'admin'。
常见误操作是直接拿 $parameters[0] 当字符串用，但没做空检查或类型判断，结果在测试环境跑得通，上线后遇到缺失参数就报 Undefined offset。
- 务必先
if (empty($parameters)) { return response('Missing middleware parameter', 403); } - 需要多个参数时，用
list($role, $action) = $parameters;或[$role, $action] = $parameters;（PHP 7.1+） - 别用
func_get_args()替代...$parameters，Laravel 不保证参数顺序
中间件注册方式影响参数是否生效
全局注册（app/Http/Kernel.php 的 $middleware）或分组注册（$middlewareGroups）都不支持传参。只有「内联中间件」才能带参数，也就是在路由定义里直接写的那种。
- ✅ 正确：
Route::get('/admin', [AdminController::class, 'index'])->middleware('check.role:admin'); - ❌ 错误：
Route::get('/admin', [AdminController::class, 'index'])->middleware('check.role');（没参数，$parameters为空数组） - ❌ 错误：
protected $middleware = [CheckRole::class];（构造函数参数不被支持）
如果你需要“默认参数”，只能在中间件内部硬编码 fallback，比如 $role = $parameters[0] ?? 'user';，但别试图在 Kernel.php 里配参数项——Laravel 不解析它。
参数值含点号、斜杠等特殊字符怎么办
路由中间件参数本质是 URL 片段，所以 :、/、.、% 等字符会被 Laravel 自动解码，但不会自动转义。比如你写 middleware:throttle:api,60,1，Laravel 会把 60,1 拆成 ['api', '60', '1'] —— 因为逗号是分隔符。
- 想传带逗号的值？用引号包住整个参数：
middleware:log.level:"error,warning"→$parameters = ['error,warning'] - 路径类参数（如
tenant:acme.com）建议统一用下划线替代点号，或提前str_replace('.', '_', $parameters[0]) - 别依赖 URL 编码传参，
%2F在中间件参数里可能被双重解码，行为不稳定
参数解析发生在路由匹配之后、中间件执行之前，没有钩子可干预。所以最稳的方式，是约定参数格式，而不是指望框架帮你兜底。
