Laravel表单PUT请求触发sumsubs.show而非update问题排查

1. 确认表单的请求方法伪装 #

Laravel资源路由中，sumsubs.update对应的是PUT/PATCH请求，但HTML原生表单仅支持GET和POST。如果缺少请求方法伪装，Laravel无法正确匹配到update路由：

• 错误示例（未添加方法伪装）：

<form action="{{ route('sumsubs.update', $sumsub) }}" method="POST">
    <!-- 表单内容 -->
</form>

• 正确写法：

<form action="{{ route('sumsubs.update', $sumsub->id) }}" method="POST">
    @csrf
    @method('PUT') <!-- 关键：伪装成PUT请求 -->
    <!-- 表单输入项 -->
    <button type="submit">提交</button>
</form>

如果表单用了GET方法，提交后会直接匹配sumsubs.show（因为show是GET请求且需要ID参数），这是最常见的触发问题的原因。

2. 验证路由参数传递正确性 #

sumsubs.update必须接收sumsub的ID作为参数，若参数错误或缺失，Laravel会错误匹配路由：

• 错误示例（传错参数）：

<!-- 传入了client的ID而非sumsub的ID -->
<form action="{{ route('sumsubs.update', $client->id) }}" method="POST">

• 正确写法：确保传入sumsub资源的ID，比如：

<form action="{{ route('sumsubs.update', $sumsub->id) }}" method="POST">

可以执行php artisan route:list命令，查看sumsubs.update的路由参数要求，确认参数传递无误。

3. 检查路由与控制器的模型绑定（若使用） #

如果用了隐式模型绑定，要保证路由参数名与控制器方法参数名一致：

• 控制器update方法（正确示例）：

public function update(Request $request, Sumsub $sumsub)
{
    // 更新逻辑
}

如果控制器参数用的是$id而非模型实例，需确保路由传递的是ID，且方法内正确查询模型：

public function update(Request $request, $id)
{
    $sumsub = Sumsub::findOrFail($id);
    // 更新逻辑
}

4. 排查路由冲突与缓存 #

• 检查路由定义顺序：如果自定义了sumsubs/*的路由在Route::resource('sumsubs', ...)之前，会优先匹配自定义路由，导致update无法触发。
• 清除路由缓存：若之前运行过php artisan route:cache，修改路由或表单后需执行：

php artisan route:clear

5. 查看请求详情验证 #

通过浏览器开发者工具的网络标签，检查提交后的请求：

• 请求方法是否为PUT（Laravel会把POST+_method=PUT转化为PUT请求）
• 请求URL是否包含正确的sumsub ID，比如/sumsubs/1

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