在Lumen框架的实际开发中，嵌套路由组是非常常用的路由组织方式，能够帮助我们按照模块、版本等维度规整路由结构。但很多开发者在使用嵌套路由组时，都会遇到URL参数提取的问题：明明在父路由组定义了参数，子路由中却无法通过自动注入获取到，这时候就需要手动提取URL参数。
Lumen路由参数的默认传递逻辑
Lumen的路由参数默认会按照路由定义的层级进行传递，但是在嵌套路由组中，如果子路由组重新定义了路由前缀或者参数规则，父路由组的参数可能会被覆盖或者无法自动注入到对应的控制器方法中。
比如我们定义了如下的嵌套路由组：
<?php
// 父路由组，定义版本前缀和user_id参数
$app->group(['prefix' => 'v1/{user_id}'], function () use ($app) {
// 子路由组，定义订单相关的前缀
$app->group(['prefix' => 'orders'], function () use ($app) {
// 订单详情路由，需要获取user_id和order_id两个参数
$app->get('/{order_id}', 'OrderController@detail');
});
});这时候如果OrderController的detail方法只定义了order_id参数，是无法自动获取到user_id的，因为嵌套路由组的参数作用域默认不会跨层自动传递，需要我们手动提取。
手动提取URL参数的两种方法
方法一：通过请求对象提取
Lumen的请求对象Illuminate\Http\Request中包含了当前请求的所有路由参数，我们可以通过请求对象的route方法获取指定参数，无论参数是在哪个层级的路由组中定义的。
对应的控制器方法实现如下：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class OrderController extends Controller
{
public function detail(Request $request, $order_id)
{
// 手动提取user_id参数，参数名要和路由中定义的参数名一致
$user_id = $request->route('user_id');
// 后续业务逻辑
return response()->json([
'user_id' => $user_id,
'order_id' => $order_id,
'msg' => '参数提取成功'
]);
}
}这种方法的优势是不需要关心参数的定义层级，只要路由中定义了对应的参数名，就可以通过$request->route('参数名')获取到，适合多层嵌套的复杂路由场景。
方法二：在路由闭包中手动传递参数
如果不想在每个控制器方法中都手动提取参数，也可以在嵌套路由组的闭包中提前提取参数，然后手动传递给子路由的控制器。
路由定义示例：
<?php
$app->group(['prefix' => 'v1/{user_id}'], function () use ($app) {
// 在父路由组闭包中提取user_id，传递给子路由
$app->group(['prefix' => 'orders'], function () use ($app) {
$app->get('/{order_id}', function (Request $request, $order_id) {
$user_id = $request->route('user_id');
// 调用控制器方法时手动传递user_id
return app(OrderController::class)->detail($request, $order_id, $user_id);
});
});
});对应的控制器方法需要调整参数顺序，接收手动传递的user_id：
<?php
public function detail(Request $request, $order_id, $user_id)
{
return response()->json([
'user_id' => $user_id,
'order_id' => $order_id,
'msg' => '参数传递成功'
]);
}注意事项
- 参数名必须和路由中定义的参数名完全一致，包括大小写，否则无法提取到对应参数。
- 如果路由中定义了同名的参数，优先级按照路由定义的层级，越内层的路由参数优先级越高，会覆盖外层的同名参数。
- 手动提取参数后，建议对参数的合法性进行校验，比如判断
user_id是否存在，避免后续业务逻辑出现异常。 - 如果使用了路由模型绑定，手动提取参数的方式依然适用，不过需要注意模型绑定的参数名也要和路由中定义的参数名一致。
常见问题解答
问：为什么自动注入的时候拿不到父路由组的参数？
答：Lumen的路由参数自动注入只会注入当前路由直接定义的参数，嵌套路由组中父层定义的参数不会自动注入到子路由的控制器方法中，需要手动提取。
问：提取参数的时候返回null是什么原因？
答：首先检查路由中是否正确定义了对应的参数名，其次检查参数名是否拼写正确，最后确认请求的路径是否匹配了对应的路由规则。
通过以上两种方法，就可以解决Lumen嵌套路由组中手动提取URL参数的问题，根据实际项目的路由复杂度选择合适的方法即可。