Laravel 10 + Filament 3自定义路由404，Filament路由正常

1. 确认路由是否被正确注册 #

执行命令查看所有已注册路由，验证自定义路由是否存在：

php artisan route:list

• 如果自定义路由不在列表中：检查RouteServiceProvider的boot方法，确认是否正确加载了routes/web.php；同时确认web路由组的配置未被修改。
• 如果自定义路由在列表中：继续排查路由匹配或执行环节的问题。

2. 排查Filament路由冲突 #

Filament后台路由可能与自定义前端路由路径重叠：

• 查看app/Providers/Filament/AdminPanelProvider.php（或对应面板的Provider），确认path设置是否和自定义路由冲突（比如Filament面板路径设为/shop会覆盖前端路由）。
• 检查Filament是否注册了通配符路由，导致优先匹配后台路径。

3. 验证Livewire组件有效性 #

针对绑定Livewire组件的路由，需确保组件正常：

• 确认组件类名、命名空间完全匹配（Linux/macOS环境大小写敏感），比如StoreFront类是否在App\Livewire目录下，文件名是否为StoreFront.php。
• 临时将Livewire路由替换为闭包测试：

  Route::get('/shop', function() {
      dd('路由正常执行');
  })->name('shop');
  

  如果闭包能正常输出，说明问题出在Livewire组件本身；如果还是404，继续排查其他环节。

4. 彻底清理缓存 #

即便执行过清缓存，也需确保全量清理，尤其是生产环境：

# 清理路由缓存
php artisan route:clear
# 清理配置缓存
php artisan config:clear
# 清理视图缓存
php artisan view:clear
# 全量清理优化缓存
php artisan optimize:clear

生产环境注意：如果之前使用了php artisan route:cache，调试阶段建议先禁用路由缓存，测试正常后再重新生成。

5. 检查服务器配置 #

确认Web服务器（Nginx/Apache）正确将请求转发到Laravel入口文件：

• Nginx：确保location /块包含：

  try_files $uri $uri/ /index.php?$query_string;
  

• Apache：确认mod_rewrite已启用，且项目根目录的.htaccess文件存在且配置正确（使用Laravel默认的.htaccess即可）。

6. 排查中间件问题 #

排除全局中间件或web组中间件的影响：

• 临时修改RouteServiceProvider中web路由组的中间件，只保留核心web中间件：

  Route::middleware(['web'])
       ->namespace($this->namespace)
       ->group(base_path('routes/web.php'));
  

  测试路由是否正常，再逐个添加之前的中间件，定位问题中间件。

7. 验证模型路由绑定（针对带参数的路由） #

比如/product/{product}这类路由，检查模型绑定逻辑：

• 确认Product模型的getRouteKeyName()方法没有自定义错误的路由键（比如设置为非唯一字段）。
• 临时替换路由为闭包，测试参数是否能正常接收：

  Route::get('/product/{product}', function($product) {
      dd($product);
  })->name('productInfo');
  

  如果参数能正常输出，说明模型查询失败导致404，检查模型数据是否存在或查询逻辑是否有问题。

8. 检查APP_URL配置 #

确认.env文件中的APP_URL与实际访问的域名一致：

APP_URL=http://your-domain.com

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