Laravel电商商品分类与属性筛选异常问题排查

问题现象 #

开发Laravel电商网站时，商品已存入数据库，支持按颜色、价格、尺寸、品牌筛选，但存在跨分类筛选问题：

• 进入男装分类页面，未筛选时仅显示男装商品
• 提交筛选条件后，结果中混入女装等其他分类的商品
• 子分类、子子分类页面存在相同问题

问题根源 #

筛选表单提交时，没有将当前分类/子分类/子子分类的slug参数传递到请求中，导致控制器执行筛选逻辑时丢失了分类约束，直接查询全量商品并应用筛选条件。

修复步骤 #

1. 修改Blade表单，携带分类层级参数 #

在筛选表单中添加隐藏字段，将当前页面的分类参数传递给控制器：

<form action="{{ route('shop', [
    'categorySlug' => $categorySlug ?? null,
    'subcategorySlug' => $subcategorySlug ?? null,
    'slug' => $slug ?? null
]) }}" method="GET" id="filter-form">
    <!-- 原有筛选输入字段 -->
    
    <!-- 添加隐藏字段传递分类参数 -->
    @if(isset($categorySlug))
        <input type="hidden" name="categorySlug" value="{{ $categorySlug }}">
    @endif
    @if(isset($subcategorySlug))
        <input type="hidden" name="subcategorySlug" value="{{ $subcategorySlug }}">
    @endif
    @if(isset($slug))
        <input type="hidden" name="slug" value="{{ $slug }}">
    @endif
    
    <input type="submit" value="Filter" class="btn btn-sm btn-primary">
    <button type="submit" name="clear" value="1" class="btn btn-sm btn-danger">Clear Filters</button>
</form>

2. 调整Shop控制器，复用分类参数 #

控制器优先从请求中获取分类参数（筛选提交时），确保筛选逻辑始终基于当前分类层级：

public function shop(Request $request, $categorySlug = null, $subcategorySlug = null, $slug = null)
{
    // 优先取请求中的分类参数（筛选提交时），其次用路由参数（首次进入页面）
    $categorySlug = $request->input('categorySlug', $categorySlug);
    $subcategorySlug = $request->input('subcategorySlug', $subcategorySlug);
    $slug = $request->input('slug', $slug);

    $data['Home_slider'] = Homeslider::where('status', '1')->get();
    $data['category'] = Category::where('status', '1')->get();
    $data['user'] = Auth::user();

    // 初始化商品查询并添加分类约束
    $products = Product::query();

    if ($categorySlug) {
        $products->byCategory($categorySlug);
    }
    if ($subcategorySlug) {
        $products->bySubcategory($subcategorySlug);
    }
    if ($slug) {
        $products->byChildCategory($slug);
    }

    $products->with('gallery');

    // 侧边栏筛选数据
    $data['min_price'] = $products->min('current_price');
    $data['max_price'] = $products->max('current_price');
    $data['color'] = Pro_attributes::where('name', 'color')->with('attribute_options')->get();
    $data['size'] = Pro_attributes::where('name', 'size')->with('attribute_options')->get();
    $data['brand'] = Brand::where('status', 1)->with('products')->get();

    // 应用筛选条件
    if ($request->filled('minamount') && $request->filled('maxamount')) {
        $minPrice = (int) str_replace('$', '', $request->input('minamount'));
        $maxPrice = (int) str_replace('$', '', $request->input('maxamount'));
        $products->whereBetween('current_price', [$minPrice, $maxPrice]);
    }

    if ($request->filled('color')) {
        $color = (array) $request->input('color');
        $products->whereHas('attributes.attribute_options', function ($query) use ($color) {
            $query->whereIn('id', $color);
        });
    }

    if ($request->filled('size')) {
        $size = (array) $request->input('size');
        $products->whereHas('attributes.attribute_options', function ($query) use ($size) {
            $query->whereIn('id', $size);
        });
    }

    if ($request->filled('brand')) {
        $brand = (array) $request->input('brand');
        $products->whereHas('brands', function ($query) use ($brand) {
            $query->whereIn('id', $brand);
        });
    }

    // 清除筛选：跳转回当前分类页面，重置筛选参数
    if ($request->filled('clear')) {
        return redirect()->route('shop', [
            'categorySlug' => $categorySlug,
            'subcategorySlug' => $subcategorySlug,
            'slug' => $slug
        ]);
    }

    // 执行查询并传递分类参数到视图
    $data['products'] = $products->paginate(12);
    $data['categorySlug'] = $categorySlug;
    $data['subcategorySlug'] = $subcategorySlug;
    $data['slug'] = $slug;

    return view('frontend.shop', $data);
}

3. 确认路由配置兼容性 #

确保shop路由支持可选的分类层级参数：

Route::get('/shop/{categorySlug?}/{subcategorySlug?}/{slug?}', [ShopController::class, 'shop'])->name('shop');

修复原理 #

• 首次进入分类页面时，路由参数初始化商品查询的分类约束
• 提交筛选表单时，隐藏字段传递分类参数，确保筛选逻辑始终基于当前分类层级
• 清除筛选按钮跳转回当前分类页面，保留分类约束的同时重置筛选参数

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