request()->query() 获取URL查询字符串参数，request()->route()->parameters() 获取路由定义的占位符参数；二者互不包含，需手动合并且query优先级高于route。
怎么区分 request()->query() 和 request()->route()->parameters()
URL 中的参数分两类：查询字符串（QueryString）和路由参数（Route Parameters），laravel 用不同方式暴露它们，混用会导致取不到值或报错。
-
request()->query()只读取 URL 中?key=value部分，比如/users?status=active&limit=10→ 返回['status' => 'active', 'limit' => '10'] -
request()->route()->parameters()只读取定义在路由中的占位符，比如Route::get('/users/{id}/edit', ...)匹配/users/123/edit→ 返回['id' => '123'] - 两者互不包含：QueryString 不会出现在路由参数里，路由参数也不会自动塞进 query 数组
如何安全获取全部参数（合并 + 去重优先级）
业务中常需“所有参数合并在一个数组里”，但必须明确谁覆盖谁。Laravel 没有内置 allWithRoute() 这种方法，得手动合并，且注意顺序：
- 先取
request()->route()->parameters()（路由参数） - 再用
request()->query()合并进去，QueryString 优先级更高（符合常见预期：显式 ?id=999 应覆盖路由里的 {id}） - 避免直接用
request()->all()—— 它还包含 POST body、上传文件等，可能引入脏数据或类型混乱
use IlluminateHttpRequest; // 在控制器方法中 public function index(Request $request) { $routeParams = $request->route()?->parameters() ?? []; $queryParams = $request->query(); $allParams = array_merge($routeParams, $queryParams); // query 覆盖 route // 示例：/posts/5?author=john → ['id' => '5', 'author' => 'john'] return response()->json($allParams); } request()->input() 和 request()->query() 的关键区别
很多人误以为 input() 是“万能取参”，但它实际是 query + request body + route 参数三者的混合读取，行为隐式且有陷阱：
-
request()->input('id')会依次查找：query → request body → route 参数 → 默认值 - 如果 POST 请求带了
id=7字段，即使 URL 是/users/5，input('id')也返回7，不是5 -
request()->query('id')则只看 query，request()->route('id')只看路由参数，更可控 - 对 GET 接口，推荐显式用
query()或route()，避免意外被 POST 数据干扰（哪怕当前没 POST）
遇到空数组或 NULL 的常见原因
调用 request()->route()->parameters() 返回空数组，不一定代表没参数，可能是以下情况：
- 当前请求未匹配到命名路由（比如中间件提前终止、404、或用了
Route::fallback()）→$request->route()为 null - 路由定义没用命名参数，比如
Route::get('/users', ...)→ 即使 URL 是/users?id=1，route()->parameters()仍是空 - 使用了可选参数但未提供值，如
{id?}且 URL 是/users/→ 该 key 不会出现在 parameters 数组中（不是null，是根本不存在） - 检查前务必加空值判断：
if ($request->route()) { ... }
路由参数和查询参数本质不同，合并逻辑不能靠猜。写接口时，先明确哪些是资源标识（走 route），哪些是筛选控制（走 query），再决定是否合并、谁覆盖谁。否则上线后参数莫名被覆盖，debug 花半天。