宝塔 Nginx 拦截了 WordPress 返回 404 的状态
像素鱼丸
20天前
90
0

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

发表评论

注册不是必须的

像素鱼丸
152 文章
0 评论
4 喜欢
最新文章

网站的 Cookie 弹窗

在当前的法规环境下(截至2026年4月),一个合规的Cookie弹窗设计必须遵循“透明、公平、明确”的原则,核心是确保用户拥有真正的选择权。 以下是现阶段设计合规Cookie弹窗的关键要点: 现阶段合规设计要点 禁止默认同意 弹窗出现时,所有非必要Cookie的选项都不能被预先勾选。用户必须通过一个明确的、主动的动作(如点击按钮或勾选方框)来表示同意。 提供平等的选择权 “拒绝”按钮必须在视觉上和 […]

网页设计中 banner、jumbotron、hero 都有什么区别

在网页设计和开发中,banner、jumbotron、hero 这些词通常指代页面顶部最引人注目的区域,但它们在具体含义和使用场景上有所区别。 🎯 核心概念辨析 Banner (横幅/条幅广告) 这是一个非常广泛的术语,通常指网页上任何矩形的广告或信息区域,可以出现在页面的顶部、侧边或底部。它更偏向于广告或信息展示的功能。 Jumbotron (巨幕) 这个词源于 Bootstrap 等前端框架, […]

宝塔 Nginx 拦截了 WordPress 返回 404 的状态

REST api 接口中,有段代码返回404,但是没有正常返回错误json: $wp_response = new \WP_REST_Response(array('error'=>'没有找到数据')); $wp_response->set_status(404); return $wp_response; 返回内容是: <html> <head><tit […]

Mirage 主题 v2.93.0 发布

更新内容: refactor 移除图片高宽比开关 refactor 移除全局的TOC生成开关 refactor 优化 header.php 中的seo模块和样式覆盖 feat 主题启用的时候,移除非当前主题注册的小工具 fix 修复分类小工具的bug feat 管理员打开后台,检查最当前设置首页布局的模块,如果缺少最新模块,就添加到隐藏模块列表中 fix 优化链接卡片样式 fix 优化热门文章样式 […]
生成中...
扫描二维码
扫描二维码
用户登录