You need to enable JavaScript to run this app. 调用Axios PUT方法请求WordPress自定义REST路由返回404错误
优惠活动
大模型
产品
解决方案
定价
更多

调用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 04:54:03