Laravel Form表单新增正常但update更新操作报错如何解决

优先排查最高频诱因：请求方法不匹配 #

Laravel资源路由默认的update方法绑定的请求类型是PUT/PATCH，而HTML原生表单只支持GET/POST两种请求方式，新增操作走POST刚好匹配可以正常运行，编辑表单如果没做方法伪造，会直接触发405错误、参数获取异常。

• 修复方式：在编辑表单的Blade模板中，和@csrf同层级添加方法伪造字段，示例：

<form action="{{ route('对应资源路由名.update', $目标模型->id) }}" method="POST">
    @csrf
    @method('PUT')
    <!-- 其余表单项和新增表单保持一致即可 -->
</form>

第二优先级：控制器update逻辑校验 #

• 检查路由模型绑定是否匹配：如果使用路由模型绑定，控制器update方法的模型参数名必须和路由占位符完全一致，比如路由定义为Route::put('article/{article}', [ArticleController::class, 'update'])，控制器方法就必须写public function update(Request $request, Article $article)，参数名$article写错会导致拿不到对应数据库记录，后续赋值保存时触发非对象属性操作错误。
• 检查批量赋值逻辑：新增能运行说明模型$fillable白名单基础配置无异常，但要确认更新时没有传入$guarded拦截的字段、主键/自动维护时间戳字段，不要直接把全量$request->all()传入更新方法，优先用$request->validated()传入校验通过的字段。
• 排查方法误用：不要在更新逻辑里调用静态create()方法，正确的更新流程是先拿到对应模型实例，赋值后调用->save()，或者用->update()方法批量更新字段。

对照报错类型快速定位 #

• 报405 Method Not Allowed：100%是上述请求方法未伪造的问题
• 报SQL相关错误（字段不存在、字段无默认值）：对比新增和编辑表单的字段名、必填项，大概率是编辑表单漏写字段、字段名拼写错误
• 报Trying to get property of non-object：优先检查路由是否正确传入待更新记录的id、路由模型绑定是否生效、传入id是否存在对应数据库记录
• 报表单验证类错误：重点检查唯一字段校验规则，更新时的唯一校验需要排除当前记录本身，示例规则：'email' => 'required|email|unique:users,email,'.$user->id，否则会判定当前记录的邮箱/手机号已被占用触发校验失败

易忽略细节排查 #

• 确认编辑表单的action地址正确拼接了待更新记录的id，漏传id会导致请求匹配到错误路由
• 如果表单包含文件上传字段，确认编辑表单和新增表单一样添加了enctype="multipart/form-data"属性，否则文件字段无法正常传值触发文件处理错误
• 如果做了权限控制，检查更新操作的权限判断逻辑，是否因为当前用户无该记录编辑权限被拦截返回错误

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