按文档写了 register_rest_route 注册路由,访问 /wp-json/mysite/v1/hello 一直返回 404,默认的 wp/v2 接口却都正常。碰到这种情况,我一般先确认改动有没有真的生效。
原因不复杂,路由注册挂在了 init 钩子上,REST 服务初始化时拿不到这条记录;命名空间或版本号和访问路径对不上同样返回 404。
「REST 端点 404」这个问题文档写得含糊,实际行为以当前版本为准,别照旧版本的结论套。改完顺手把文档补一句,省得下次自己重新推一遍。
add_action('rest_api_init', function () {
register_rest_route('mysite/v1', '/hello', [
'methods' => 'GET', 'callback' => 'my_hello',
]);
});
监控和日志的时间要对上,时区不一致会多绕很大一圈。临时改动用注释写上日期和原因,过两周自己都记不清为什么这么写。
动手前把原文件复制一份带时间戳,出问题立刻换回去,比现场分析快得多。一次只改一处,改完立刻验证,几个改动叠在一起,出问题就说不清是谁导致的。
具体做法是,把注册代码改挂到 rest_api_init 钩子里执行;核对命名空间与路径逐段拼写和斜杠位置;调 REST 索引接口确认路由是否出现在列表里。
最后用这个标准收尾,访问该地址返回 JSON,路由索引里也能查到这条记录。
