宝塔 Nginx 拦截了 WordPress 返回 404 的状态
像素鱼丸
04-03
140

REST api 接口中,有段代码返回404,但是没有正常返回错误json:

$wp_response = new \WP_REST_Response(array('error'=>'没有找到数据'));
$wp_response->set_status(404);
return $wp_response;

返回内容是:

<html>
<head><title>404 Not Found</title></head>
<body>
<center><h1>404 Not Found</h1></center>
<hr><center>nginx</center>
</body>
</html>
这个问题非常典型,通常不是你的 PHP 代码写错了,而是 Nginx 服务器配置 拦截了 WordPress 返回的 404 状态。
要解决这个问题,你需要检查并修改 Nginx 的配置文件。以下是详细的排查和修复步骤:

核心解决方案:修改 Nginx 配置

你需要确保 Nginx 将所有请求(包括 404 状态的请求)都交给 WordPress 的 index.php 处理,而不是由 Nginx 自己处理。
  1. 进入宝塔面板
    • 点击左侧菜单的 “网站”
    • 找到你的站点,点击右侧的 “设置”
    • 点击左侧的 “配置文件”(注意:不是“伪静态”)。
  2. 查找并注释掉 error_page
    • 在配置代码中搜索 error_page 404
    • 你通常会看到类似下面的一行代码(通常在 #ERROR-PAGE-START 和 #ERROR-PAGE-END 之间):
      error_page 404 /404.html;
    • 操作:在这一行前面加一个 # 号把它注释掉,或者直接删除这一行。
      #error_page 404 /404.html;
    • 保存配置。
  3. 检查 location / 配置(关键)
    • 确保你的配置中包含标准的 WordPress 伪静态规则,特别是 try_files 指令。
    • 检查 location / { ... } 块是否包含以下内容:
      location / {     try_files $uri $uri/ /index.php?$args; }
    • 如果没有,请在 “伪静态” 设置中选择 wordpress 规则,或者手动补全。
  4. 重启 Nginx
    • 修改配置后,点击宝塔面板左侧的 “软件商店” -> “运行环境” -> 找到 Nginx -> 点击 “重启”,或者在终端执行 bt 13 选择重启 Nginx。 验证修复
修改完 Nginx 配置并重启后,再次使用 Postman 或浏览器访问你的接口:
  • 预期结果:你应该能看到你的 JSON 数据 {"error":"没有找到数据"},同时状态码为 404。
  • 如果仍然失败:请检查你的 PHP 代码中,new \WP_REST_Response 的注册路由是否正确,确保请求确实进入了你的回调函数(可以在函数第一行加 error_log('test'); 查看 PHP 错误日志,确认代码是否被执行)。
收藏
打赏
Mirage 主题 v2.93.0 发布
上一篇
网页设计中 banner、jumbotron、hero 都有什么区别
下一篇

发表评论

注册不是必须的

像素鱼丸
157 文章
2 评论
4 喜欢
最新文章

付费资源下载时间限制有什么用?

这个功能确实挺常见的,它背后的逻辑其实不是“防君子”,而是“防小人”和“控成本”。有没有必要做,主要取决于你平台上的资源类型和你的运营阶段。 我们可以从三个角度来看看这个“10天有效期”到底有什么用: 增加倒卖和二次传播的成本(防黄牛) 这是最核心的意义。如果你的资源是虚拟商品(比如教程、源码、素材包),用户付一次钱理论上可以无限复制。 如果没有有效期: 一个人买了,转手挂到闲鱼或者别的群里卖,你 […]

退款和取消订单接口要不要合并

很多开发者在设计初期的常见思路。将“取消”和“退款”分开,从功能上看似乎很清晰,但在实际的复杂业务场景中,这种设计可能会带来一些问题。 更主流和推荐的设计是提供一个统一的“申请取消订单”接口,由后端服务根据订单的当前状态,自动路由到不同的处理逻辑。  为什么统一接口是更好的选择? 前端逻辑简化: 对于用户而言,他的诉求只有一个:“我不想要这个订单了”。无论订单是否支付,他在前端点击的都是“取消订单 […]

Mirage 主题 v3.7.0 发布

Mirage 主题 v3.7.0 发布 feat 增加拉黑用户功能 feat 移动端向下滑动时隐藏header,向上滑动时显示header 下载地址 https://gitee.com/vthemecn/mirage/releases/tag/v3.7.0 https://github.com/vthemecn/mirage/releases/tag/v3.7.0 新增功能截图
生成中...
扫描二维码
扫描二维码