route() 函数传参必须匹配命名路由的占位符名
Laravel 里生成带参数的 URL，核心是 route()，但它不是“拼字符串”，而是严格按路由定义里的占位符名来传值。如果名字对不上，会报 Missing required parameters for [Route: xxx] 错误。
比如路由定义是：Route::get('/user/{id}/profile', [ProfileController::class, 'show'])->name('profile.show');，那调用时必须写 route('profile.show', ['id' => 123])，不能写成 ['user_id' => 123] 或 [123]（索引数组不支持）。
- 命名参数键名必须和路由 URI 中的花括号变量名完全一致（区分大小写）
- 可选参数（如
{slug?}）可以不传，但一旦传了就必须用对应键名 - 如果路由有多个参数，顺序无关，全靠键名匹配 —— 这点和
url()完全不同
带查询参数（query string）要单独加，不能塞进 route() 的参数数组
route() 只负责生成路径部分（path），问号后面的查询参数得另外处理。硬塞进去会导致参数被当路径变量，URL 错乱甚至 404。
例如想生成 /post/5/edit?from=dashboard&ref=sidebar，不能写：route('post.edit', ['id' => 5, 'from' => 'dashboard']) —— 这会让 Laravel 尝试找一个叫 {from} 的路由占位符，而它并不存在。
- 正确做法是：先用
route('post.edit', ['id' => 5])拿到基础 URL，再用app('url')->full()或手动拼接（更推荐前者） - 简洁写法：
route('post.edit', ['id' => 5]) . '?from=dashboard&ref=sidebar'，但要注意 URL 编码（中文或特殊字符需urlencode()） - Laravel 9+ 可用
UrlGenerator::to()配合http_build_query()，但多数场景直接拼接更直白
redirect()->route() 传参方式和 view 中 route() 完全一致
控制器里做跳转用 redirect()->route()，参数规则和 Blade 模板里一模一样。新手常以为「重定向」能松一点，其实底层调用的是同一个 route() 辅助函数。
典型翻车现场：return redirect()->route('user.update', [123]); —— 报错，因为命名路由定义是 {user} 占位符，你却传了索引数组；又或者写成 ['id' => 123]，但路由实际是 /users/{user}，键名错配。
- 务必打开
routes/web.php确认命名路由的 URI 占位符名 - 使用
php artisan route:list快速核对 name 和 uri 列，眼见为实 - 在测试环境开启调试模式（
APP_DEBUG=true），错误信息会明确告诉你缺哪个参数、期望什么键名
生成绝对 URL 要显式配置 APP_URL，否则 route() 默认返回相对路径
route() 默认生成的是相对路径（如 /post/5），前端发请求时依赖当前域名。如果发邮件、API 响应或跨域场景需要完整地址（https://example.com/post/5），必须确保 APP_URL 在 .env 里设对，且以 http:// 或 https:// 开头。
常见坑：APP_URL=localhost 或 APP_URL=/ 都无效；线上用 https 但环境变量写成 http，导致生成的链接被浏览器拦截或跳错协议。
- 检查命令：
php artisan tinker→ 输入url()->to('/')，看输出是否是你预期的完整域名 - 部署时别忘了同步
.env，Docker 或 CI 环境常漏配这个 - 多租户或动态域名场景，不能只靠
APP_URL，得用Request::getSchemeAndHttpHost()手动拼，但这是进阶需求，基础项目配对就行
参数名错一位、APP_URL 少个 s、查询参数混进路由数组——这些地方没报错提示，但 URL 就是打不开。盯住路由定义本身，比查文档更快。
