laravel 命名路由修改后旧 route() 调用立即失效，因 route() 严格匹配定义的字符串名称，不支持模糊匹配、大小写容错或自动映射；须全局替换模板与控制器中的旧名，并用 route:list 验证新名是否注册生效。
修改 Laravel 命名路由后，所有用 route('old.name') 生成的链接、重定向、表单 action 都立刻变成 404 或“Route not defined”错误，不是代码没保存，是 Laravel 不会自动映射新旧名称——它只认你当前 ->name() 写进去的那个字符串。
确认失效根源：route() 调用与定义必须字面一致
打开终端，运行：php artisan route:list --compact
在输出中逐行查找你正在调用的路由名（如 search.get_kcli）。如果该名称未出现，说明它根本没被注册；如果出现的是 search，而你在 Blade 中写的是 route('search.get_kcli')，那这就是硬性不匹配——Laravel 不做模糊匹配、不自动补前缀、不忽略大小写。
⚠️ 注意：【route() 函数对名称完全敏感，多一个点、少一个字母、大小写错位，都直接抛异常】
批量修复模板中所有过期的 route() 调用
方法一：全局搜索替换（推荐用于命名规范统一的项目）
在 IDE 中执行全局搜索：route('old.name') → 替换为：route('new.name')
注意：必须加单引号，且保留所有空格和括号结构，避免误改注释或字符串内容。
方法二：用 Blade 指令包裹降级兜底（适用于灰度发布或临时兼容）
将原写法：{{ route('old.name') }}
改为：{{ route('new.name', $parameters ?? []) ?? '#' }}
这样即使 new.name 尚未部署，页面也不会崩溃，而是跳转到 # 空链接。
修复控制器中的重定向调用
第一步：定位所有 redirect()->route('xxx') 和 return redirect()->route('xxx') 调用点
第二步：逐个核对 xxx 是否存在于 php artisan route:list 输出中
第三步：若不存在，立即同步为新名称，并检查是否传入了正确参数（例如 route('user.profile', ['id' => 123]) 中的 id 键必须与路由定义中占位符名一致）
第四步：特别检查中间件里的重定向逻辑（如 RedirectIfAuthenticated 的 handle() 方法），这类代码容易被忽略，但一旦出错会导致登录后无限跳回首页或白屏。
验证新路由名是否真正生效
运行：php artisan route:clear
再运行：php artisan route:list --compact | grep "new.name"
如果返回一行包含 GET|HEAD 或 POST 及对应 URI 的记录，说明命名已加载；如果无输出，回头检查 routes/web.php 中是否漏写了 ->name('new.name')，或该行前面有语法错误导致后续整块路由未解析。
