调用Axios PUT方法请求WordPress自定义REST路由返回404错误
自定义REST接口返回404的问题定位与修复
核心触发原因
- 请求方法与路由注册规则不匹配:你在WordPress中注册路由时仅允许
POST方法访问,但前端Axios使用$put(即PUT方法)发起请求,WordPress REST路由会对请求方法做精准匹配,对应路径下未定义PUT方法的规则时,会直接返回404。 - 路由注册缺失必填参数:WordPress 4.7及以上版本强制要求所有REST路由必须传入
permission_callback参数做权限校验,漏写这个参数的时候WP不会报任何语法错误,只是对应的路由压根不会加载到REST系统里,无论用什么方法访问都会返回404,很多人踩过这个排查很久的坑,你当前的注册代码就没有加这个参数。 - 重写规则缓存未刷新:修改自定义路由后,如果没有刷新WordPress的固定链接重写规则,服务器的路径映射缓存会拦截新定义的REST路径,直接返回404。
修复操作步骤
1. 修改WordPress端路由注册代码
将你当前functions.php中的注册代码替换为以下内容,同时匹配两种请求方法、补全必填的权限校验参数:
add_action('rest_api_init', function () { register_rest_route( 'contact/v1', 'send', array( 'methods' => ['POST', 'PUT'], // 同时支持POST、PUT方法,覆盖前后端的调用逻辑 'callback' => 'sendContactMail', 'permission_callback' => function() { // 公开提交类接口直接返回true即可,业务需要鉴权可在此补充校验逻辑 return true; } )); });
如果你的业务不需要支持PUT方法,也可以在路由里只保留POST方法,后续前端同步修改请求方法即可。
2. 适配前端请求逻辑
二选一即可:
- 保留原路由仅支持POST的配置:将前端代码里的
this.$axios.$put替换为this.$axios.$post,和路由注册的方法保持一致,修改后的代码如下:this.$axios.$post(`${this.baseUrl}/wp-json/contact/v1/send`, formData) .then((res) => { this.success = true }) .catch((err) => { this.$toast.error(err.response) }) - 保留前端使用PUT方法的逻辑:同步更新后端路由的允许方法列表,支持PUT请求。
3. 刷新重写规则缓存
修改完代码后,进入WordPress后台的「设置-固定链接」页面,不需要修改任何参数,直接拉到页面底部点击「保存更改」,即可触发系统自动刷新路径重写规则。
验证方式
直接在浏览器访问http://my-project.com/wp-json/,在返回的路由列表中查找contact/v1/send条目,确认该条目下标注的允许请求方法包含前端实际调用的方法,即代表路由注册成功。
内容的提问来源于stack exchange,提问作者drake035
相关产品推荐
相关产品推荐

