Ziggy Router为何默认将路由参数转为查询字符串？

问题场景 #

尝试访问路径参数式路由localhost:8000/contact/edit/{contact}，在Vue中使用Ziggy的route函数：

<Link :href="route('contact.edit', {contact:contact.id})">Edit Contact</Link>

Laravel路由配置：

Route::prefix('contact')->group(function() {
    Route::post('/', [ContactController::class, 'store'])->name('contact.store');
    Route::get('/create/{customer}', [ContactController::class, 'create'])->name('contact.create');
    Route::get('/edit/{contact}', [ContactController::class, 'edit'])->name('contact.edit');
});

控制器使用路由模型绑定：

public function edit(Contact $contact) {
    dd($contact);
}

操作时先报错Error: Ziggy error: 'contact' parameter is required for route 'contact.edit'.，移除参数必填约束后，Ziggy生成的URL变成http://localhost:8000/contact/edit?contact=88，而非预期的路径参数形式。

核心原因 #

Ziggy没有正确识别contact.edit路由中的{contact}为路径参数，而是将其判定为查询参数。通常由以下情况导致：

• Ziggy的路由清单未同步最新的Laravel路由定义，比如新增路由后没重新生成清单；
• 路由缓存导致Ziggy读取的是旧路由信息；
• Ziggy配置中意外排除了该路由，导致无法正确解析参数类型。

解决步骤 #

1. 重新生成Ziggy路由清单
   运行Artisan命令强制同步最新路由：

   php artisan ziggy:generate
   

   该命令会更新resources/js/ziggy.js文件，确保Ziggy获取到contact.edit路由的正确参数定义。

2. 检查路由参数名一致性
   确认Vue中传递的参数名与Laravel路由中的参数名完全匹配（大小写敏感）：路由里是{contact}，传递的参数键名必须是contact，不能是id或其他变体。

3. 验证Ziggy路由包含配置
   打开config/ziggy.php，检查only或except配置项，确保contact.edit路由没有被排除。默认配置下Ziggy会包含所有命名路由，若有自定义过滤规则需调整。

4. 恢复路由参数必填约束
   解决问题后，把路由中{contact}的必填约束加回去——这是路径参数的合理要求，移除约束只是临时规避问题。

验证效果 #

完成上述步骤后，再次调用route('contact.edit', {contact: contact.id})，应该会生成预期的路径参数URL：http://localhost:8000/contact/edit/88，控制器也能正常通过路由模型绑定获取到Contact实例。

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