Laravel项目报错‘Route [searchbybrand] not defined’的解决求助

问题场景 #

我正在用Laravel开发电商Web应用，设置了「按品牌购物」板块，目标是点击品牌图片时展示该品牌的产品，目前仅针对「Fanola」品牌做功能测试。

现有代码 #

Blade模板代码 #

<div class="brand-slides owl-carousel owl-theme">
    <div class="brand-item">
        <a href="{{route('searchbybrand')}}"><img src="assets/img/brand/shopbybrand1.jpg" alt="image"></a>
    </div>
</div>

控制器代码（HomeController） #

public function searchVendor()
{
    $searchproduct="Fanola";
    $product=product::Where('vendor','LIKE',"%$searchproduct%")->get();
    return view('home.userpage',compact('product'));
}

初始路由（web.php） #

Route::get('/searchbybrand', [HomeController::class, 'searchVendor']);

遇到的错误 #

1. 运行时提示：Route [searchbybrand] not defined.，已尝试清除路由缓存，无效。
2. 参考建议修改路由为以下写法后，新错误：Target class [HomeController] does not exist.

Route::get('search-by-brand', 'HomeController@searchVendor')->name('searchbybrand');

执行了composer dump-autoload、php artisan config:clear、php artisan cache:clear，问题仍未解决。

解决方案 #

1. 修正路由配置（适配Laravel 8+） #

Laravel 8及以上版本默认不再自动引入控制器命名空间，需使用数组写法+控制器类引入，同时给路由命名：

// 在web.php顶部引入控制器
use App\Http\Controllers\HomeController;

// 基础写法（固定测试品牌）
Route::get('/search-by-brand', [HomeController::class, 'searchVendor'])->name('searchbybrand');

// 进阶写法（支持动态传品牌参数）
Route::get('/search-by-brand/{brand}', [HomeController::class, 'searchVendor'])->name('searchbybrand');

2. 修正控制器代码 #

• 模型名需遵循Laravel约定，首字母大写（Product而非product）
• 支持动态接收品牌参数，避免硬编码：

// 顶部引入Product模型
use App\Models\Product;

public function searchVendor($brand = null)
{
    // 优先用传入的品牌参数，默认值保留Fanola做测试
    $searchProduct = $brand ?? 'Fanola';
    // 模型名大写，变量名规范
    $products = Product::where('vendor', 'LIKE', "%{$searchProduct}%")->get();
    return view('home.userpage', compact('products'));
}

3. 修正Blade模板（支持动态传参） #

如果用了进阶路由，需要在跳转链接中传入品牌参数：

<div class="brand-slides owl-carousel owl-theme">
    <div class="brand-item">
        <a href="{{ route('searchbybrand', ['brand' => 'Fanola']) }}">
            <img src="assets/img/brand/shopbybrand1.jpg" alt="Fanola品牌">
        </a>
    </div>
</div>

错误原因说明 #

• 第一个错误：初始路由未添加->name('searchbybrand')命名，导致Blade中的route()方法无法匹配到对应路由。
• 第二个错误：Laravel 8+废弃了控制器@方法的字符串写法，必须使用数组形式并引入控制器类，否则框架无法找到控制器的命名空间。

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