为何Laravel 8.x中Request类无法正常接收PUT请求参数？

版本规则差异本质 #

• 旧版兼容逻辑（含Laravel 5.x）：对所有请求方法的表单格式请求体，都会自动触发参数解析，将解析结果合并到Request对象的参数集合中，无论请求是POST、PUT、PATCH还是DELETE。
• Laravel 8 变更后的逻辑：跟随底层Symfony HTTP Foundation组件的大版本规则调整，默认仅对POST请求的表单格式请求体做自动解析，PUT/PATCH/DELETE这类非POST请求的表单格式请求体，不会被框架主动读取、解析，直接导致Request对象中所有提交的参数为空。

故障链路匹配 #

当前前端请求链路完全匹配该变更的失效触发条件：

• 前端通过axios.put传入FormData对象时，axios会自动携带multipart/form-data格式的表单请求头，属于典型的表单格式提交
• 因为请求方法是PUT，Laravel 8不会触发对应表单解析流程，哪怕前端参数携带完全正确，后端也无法从请求体中读取到参数
• 同参数换为POST请求时，匹配框架默认的POST解析规则，参数可正常写入Request对象，和实际排查的现象完全一致

可落地解决方法 #

• 方法1（全版本兼容推荐）：采用Laravel官方推荐的方法伪装方案，将请求改为POST提交，在FormData中追加_method字段，值设为PUT，框架的方法伪造中间件会自动将该POST请求识别为PUT请求，同时走正常的POST表单解析逻辑读取参数，可兼容所有Laravel版本。
• 方法2（保留原生PUT请求）：在全局中间件或路由中间件中，手动触发请求体解析，将非POST请求的表单参数合并到Request的参数集合中，弥补框架默认逻辑的缺失。
• 方法3（无方法伪装的PUT请求）：调整前端请求头，将PUT请求的内容格式从表单格式改为application/json格式，Laravel会对所有方法的JSON格式请求体做自动解析，参数可正常读取。

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