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

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

发表评论

注册不是必须的

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

VooShop 商城主题

主题简介 Vooshop 是一个简单精美的 WordPress 主题,支持自适应、暗黑模式、多语言等功能,可以用于企业、团体、自由职业者或更广泛的主页。 Vooshop:回归 WooCommerce 的纯粹与极速 零冗余代码,零多余功能。一个完全依赖 WooCommerce 原生能力的轻量级主题。 Vooshop 不做 WooCommerce 做不到的事,我们只负责让它跑得更快。 市面上的主题总试 […]

XZhan 主题

主题简介 XZhan 主题(中文名称:小站主题)是一款 WordPress 企业主题,支持自适应、暗黑模式等功能,可快速构建高质量的企业网站。   主题特色 支持白天与暗黑模式 自适应设计,兼容多种主流浏览器 自定义主色调 LOGO扫光动画 自定义SMTP支持 内置SEO功能 文章支持点赞、分享和海报生成 丰富的小工具 侧边栏粘性滚动 简介的主题设置面板 主题设置可导入和备份 多级子菜单 […]

StarFish 配置框架

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

什么是幽灵按钮

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

您确定要购买此资源吗?

微信扫码支付

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

订单号:

等待支付...