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

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 都有什么区别
下一篇

发表评论

注册不是必须的

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

StarFish 配置框架

一个轻量级的 WordPress 选项框架插件,通过配置化的方式,快速为 WordPress 主题或插件生成后台设置页面。 ✨ 特性 🎯 配置驱动 UI:只需定义数组配置,自动生成完整的表单界面 📱 多页面架构:支持多个独立的设置页面 🎨 丰富的字段类型:包含 15+ 种常用字段类型 🔗 字段依赖系统:实现字段间的联动效果 ✅ 数据验证与清理:自动进行安全清理,防止 XSS 攻击 🚀 零依赖:使用 […]

什么是幽灵按钮

“幽灵按钮”(Ghost Button)是一种常见的网页与移动应用 UI 设计模式,指背景透明(或半透明)、仅通过边框(border)和文字(text)定义的按钮,视觉上“若隐若现”,仿佛“幽灵”一般——因此得名。 核心特征: 无填充色(transparent background) 背景完全透明(或与父容器同色),不遮挡背后内容。 清晰的边框(通常 1–2px 实线) 如 border: 2px […]

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

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

测试产品

生成中...
扫描二维码
扫描二维码
确认购买

您确定要购买此资源吗?

微信扫码支付

请使用微信扫描二维码完成支付

订单号:

等待支付...