如何设置Nginx Error_page，实现ThinkPHP自定义错误页面？

本文共计786个文字，预计阅读时间需要4分钟。

如果您的ThinkPHP项目中配置了Nginx的`error_page`指令，但自定义错误页面未生效，很可能是因为Nginx拦截了错误响应。这可能导致PHP层的ThinkPHP路由逻辑（如`Route::miss()`）未能执行。

以下是解决此问题的步骤：

一、禁用Nginx对404的直接拦截

Nginx默认可能通过error_page 404或try_files规则提前返回404，使请求无法到达ThinkPHP。必须确保Nginx不主动截断404，而是交由PHP处理。

1、打开Nginx站点配置文件（如/etc/nginx/sites-enabled/your-site）。

2、查找并注释或删除形如error_page 404 /404.html;或error_page 404 = /404.html;的行。

立即学习“PHP免费学习笔记（深入）”；

3、检查location /块中的try_files指令，确保其末尾不是=404，而应为$uri $uri/ /index.php?$query_string;。

4、执行sudo nginx -t && sudo systemctl reload nginx重载配置。

二、启用ThinkPHP路由强制模式

ThinkPHP 6.x需开启url_route_must，否则URL解析可能绕过路由系统，导致404不触发miss()回调。