宝塔 Nginx 拦截了 WordPress 返回 404 的状态
像素鱼丸
2小时前
5
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 发布
上一篇
没有了
下一篇

发表评论

注册不是必须的

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

宝塔 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 优化热门文章样式 […]

如何使用 WordPress Setting API

使用 WordPress 的 Setting API 是在插件或主题中创建和管理设置页面的标准方式。它提供了一种结构化、安全的方式来保存和获取用户配置的选项。 ✅ 一、Setting API 简介 WordPress 的 Setting API 允许你: 创建设置页面(Settings Page) 注册设置字段(Settings Field) 验证和保存设置数据 使用表单提交来更新设置 ✅ 二、基 […]

详解 WordPress 的评论设置

好的,我们来详细梳理并总结 WordPress 中关于文章评论的两个核心控制层级:全局设置和单篇设置。理解这两者的关系(优先级)是管理网站评论的关键。 1. 全局设置 (Global Settings) —— 网站的“默认规则” 这是整个网站评论系统的总开关和默认行为准则。它决定了新发布的文章默认是什么样子的。 位置:WordPress 后台仪表盘 -> 设置 (Settings) -> […]
生成中...
扫描二维码
扫描二维码
用户登录