提交带wire:submit.prevent的表单时Laravel路由通配符变为数字如何解决

问题产生原因 #

• 路由与模型绑定逻辑不匹配：你的路由规则定义为/invoices/{invoice_token}，使用字符串类型的token作为查询依据，但Livewire在处理组件重渲染（表单提交触发组件更新属于重渲染场景）时，默认会读取公共模型属性的数字主键作为路由参数值，自动同步到浏览器地址栏，就会出现你看到的token变为16、17这类数字ID的情况。
• 未显式保留原始路由参数：如果你的组件没有将invoice_token声明为独立的公共属性，Livewire在同步路由状态时会丢失原始的字符串token，直接使用模型主键替换原有参数。

修复方案 #

方案1：全局指定模型路由键（最推荐） #

在Invoice模型中指定默认路由查询字段为你的token字段，Laravel和Livewire都会自动适配：

// app/Models/Invoice.php
public function getRouteKeyName()
{
    // 此处替换为你实际存储账单token的字段名
    return 'token';
}

方案2：路由显式指定绑定字段 #

如果你只需要这个路由用token查询，不需要修改模型全局配置，可以直接修改路由定义：

// routes/web.php
// 将原来的参数名{invoice_token}改为{invoice:token}，冒号后指定绑定的字段名
Route::get('/invoices/{invoice:token}', [\App\Http\Livewire\Invoice\Show::class])->name('invoices.show');

方案3：组件显式保留token参数 #

在Livewire组件中将token声明为公共属性，自行处理查询逻辑，避免Livewire自动读取模型主键：

// app/Http/Livewire/Invoice/Show.php
public string $invoice_token;
public $invoice;

public function mount()
{
    $this->invoice = Invoice::where('token', $this->invoice_token)->firstOrFail();
}

方案4：禁用路由自动同步（如果不需要动态调整路由） #

如果你的组件不需要修改地址栏参数，可以直接关闭Livewire的路由同步功能：

// app/Http/Livewire/Invoice/Show.php
// Livewire 2.x 配置
protected $queryString = [];

// Livewire 3.x 额外增加配置
protected bool $preserveQueryStrings = false;

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