Laravel 8配置动态路由访问时出现500错误如何解决？

优先定位具体报错 #

所有Laravel 500错误首先要拿到明确的报错信息，避免盲目排查：

• 打开项目根目录.env文件，将APP_DEBUG参数值改为true，重新访问带参数的路由即可看到完整报错堆栈
• 若不方便开启调试模式，直接查看storage/logs/laravel.log文件中最新的500错误日志，定位报错触发位置

常见问题及修复方案 #

1. 路由参数命名冲突（当前场景最高概率触发的问题） #

你当前路由定义的可选参数名为slug，但闭包接收参数写为$request，Laravel会优先将$request识别为Illuminate\Http\Request请求实例的注入变量，传参时字符串类型的slug值会和依赖注入规则产生冲突，进而触发报错。
修正路由代码如下即可：

Route::get('/{slug?}', function ($slug = '') {
    $code = empty($slug)? '47ZH2' : $slug;
    return view('home', ['code' => $code]);
})->where('slug','^([0-9A-Za-z\-]+)?');

2. 路由优先级错误 #

你定义的是匹配所有路径的兜底路由，必须放在routes/web.php文件的最末尾，否则会拦截排在它后面的其他明确路由，将其他路由的路径当作slug参数传入，触发后续逻辑报错。

3. 视图逻辑兼容问题 #

不传参时访问正常，说明视图在$code = '47ZH2'的场景下运行无异常，传参后报错需要排查home.blade.php中是否对$code变量有特殊规则校验（比如固定长度、字符格式限制），传入的slug不符合规则时触发了异常。

4. 路由缓存未更新 #

如果生产环境开启了路由缓存，修改路由规则后需要执行以下命令更新缓存：

# 清除旧路由缓存
php artisan route:clear
# 生成新路由缓存
php artisan route:cache

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