Laravel 11 路由机制与 9/10 兼容，无破坏性变更；基础 GET 路由须写在 routes/web.php，使用 Route::get() 并确保 return 和视图存在，命名路由需显式调用 name() 且全局唯一。
直接说结论：Laravel 11 的路由机制和 Laravel 9/10 几乎一致，没有破坏性变更；Route::get()、name()、group() 这些核心用法照常可用，但闭包路由仍无法被 route:cache 缓存，控制器写法仍是生产环境首选。
怎么写一条能跑通的基础 GET 路由
别在 routes/api.php 里写网页跳转逻辑，也别漏掉 use Illuminate\Support\Facades\Route; —— 这两个错误占新手报错的七成以上。基础路由必须落在 routes/web.php，且默认已包裹在 Route::middleware('web')->group(...) 内（Laravel 8+ 默认结构），所以 session 和 CSRF 自动生效。
-
Route::get('/about', function () { return view('about'); });—— 闭包写法，适合临时调试 -
Route::get('/contact', [PageController::class, 'contact']);—— 控制器写法，类名必须带完整命名空间（App\Http\Controllers\开头） - 路径末尾斜杠不自动兼容：
/users和/users/是两条独立路由，别指望它自动 301 重定向 - 如果返回空白页但控制台没报错，先检查是否忘了
return，或视图文件resources/views/about.blade.php根本不存在
为什么 route('dashboard') 报错 “Route [dashboard] not defined”
命名路由不是“写了就生效”，而是必须在定义路由时显式链式调用 name()，且名称全局唯一。常见翻车点是：在分组里用了 name('admin.') 却忘了给子路由单独命名，或者拼错了字符串。
- 单个路由命名：
Route::get('/dashboard', [DashboardController::class, 'index'])->name('dashboard'); - 带参数的命名：
Route::get('/user/{id}', [UserController::class, 'show'])->name('user.show');，调用时必须传参：route('user.show', ['id' => 123]) - 分组统一前缀：
Route::name('admin.')->prefix('admin')->group(function () { Route::get('/users', [AdminController::class, 'users'])->name('users'); });→ 最终生成的完整名是admin.users - 查漏命令：
php artisan route:list --name=dashboard或全量看：php artisan route:list
中间件在 Route::group() 里不生效的真正原因
不是语法错了，而是中间件执行顺序或缺失依赖。最典型的是加了 auth 却没加 web —— auth 依赖 session，而 session 只在 web 中间件组里启动。
- 正确写法：
Route::middleware(['web', 'auth'])->group(function () { ... });，顺序不能颠倒 - 别嵌套三层以上分组，容易搞混中间件继承关系；两层足够，三层建议拆到独立文件再
require -
prefix只影响匹配和生成 URL 的路径部分，不影响重定向跳转逻辑本身；比如redirect()->route('admin.users')会生成/admin/users，不是/users - 自定义中间件必须在
app/Http/Kernel.php的$routeMiddleware数组里注册才能被识别
资源路由生成的 7 条路径哪些能删、哪些不能动
Route::resource('posts', PostController::class) 生成的 7 条路由（index、create、store、show、edit、update、destroy）中，store 和 update 是表单提交入口，show 是详情页主入口 —— 这三类一旦删掉，对应功能就彻底不可达，且不会自动 fallback。
- 可安全排除的：用不到的
create（新建表单页）、edit（编辑表单页），加->except(['create', 'edit']) - 必须保留的：
index（列表页）、show（详情页）、store（POST 提交创建）、destroy（删除动作）—— 尤其是store，它绑定了 POST 方法，删了就收不到表单数据 - 资源路由默认不包含
api中间件，哪怕写在api.php里；如需 token 验证，得手动加middleware('auth:sanctum') - 资源路由不支持闭包，必须指向控制器方法；否则抛出
InvalidArgumentException
最关键的细节往往藏在中间件顺序、命名唯一性和缓存限制里——比如你跑了 route:cache，所有闭包路由就直接失效，但错误提示可能只显示“404”，而不是告诉你缓存不支持闭包。
