Laravel向ProductsController传递产品分类参数的路由问题处理

1. Laravel默认Route::resource注册的index方法对应的路由路径是/products，本身不带任何路径参数，你直接给控制器index方法加Category $category参数，框架不会自动绑定路由参数，这个修改本身不会生效。
2. 资源路由默认注册顺序中，/products/{product}的show路由优先级更高（路由匹配遵循先注册先匹配的规则），当你访问/products/Parts时，框架会优先命中show路由，把Parts当作Product模型的主键ID去做隐式模型绑定，根本不会走到你修改后的index方法。

第一步：调整路由注册顺序与规则 #

你需要把自定义的分类产品列表路由放在资源路由之前注册，避免被show路由截胡，同时给分类参数加枚举值匹配规则，从路由层拦截非法参数，也避免和产品详情路由冲突。
路由定义代码参考：

use App\Enums\Category;
use App\Http\Controllers\ProductsController;
use Illuminate\Support\Facades\Route;

// 优先注册带分类参数的产品列表路由
Route::get('products/{category}', [ProductsController::class, 'index'])
    ->where('category', implode('|', array_column(Category::cases(), 'value')));

// 再注册资源路由，排除已经自定义实现的index路由
Route::resource('products', ProductsController::class)->except('index');

如果需要保留不带参数访问/products的入口，可以给category参数设置默认值（比如默认传入Category::All），或者额外加一个根路径重定向规则，按需调整即可。

第二步：保留控制器原有枚举绑定逻辑 #

Laravel原生支持枚举类型的路由参数绑定，只要路由参数名和控制器方法参数名一致就能自动解析，你之前写的控制器逻辑不需要大改，补充业务代码即可：

/**
 * Display a listing of the resource.
 *
 * @return \Illuminate\Http\Response
 */
public function index(Category $category)
{
    $products = Product::when(
        $category !== Category::All,
        fn($query) => $query->where('category', $category->value)
    )->paginate(10);
    
    return view('products.index', compact('products', 'category'));
}

额外注意点 #

• 如果你实际访问路径带/admin前缀，记得把上述路由放到admin前缀的路由分组中，否则会出现匹配不到的问题。
• 不要尝试修改资源路由的默认参数顺序来适配需求，前置注册自定义路由的方式维护成本最低，完全符合Laravel的路由设计逻辑。
• 加了枚举值正则约束后，产品详情页的数字ID（比如/products/123）不会匹配到分类路由，会正常走到show方法，不会产生路由冲突。

内容的提问来源于stack exchange，提问作者HockChai Lim