thinkphp项目中404页面未生效时，应优先使用路由miss()方法（tp6.x推荐），其次配置tmpl_exception_file（tp3.2/5.x旧版），或定义emptycontroller（tp3.2/5.x空控制器机制）。
如果您在ThinkPHP项目中访问了不存在的URL，但页面未显示自定义404内容，而是返回默认错误提示或空白响应，则可能是由于404处理机制未正确启用或被Web服务器拦截。以下是多种可靠且经验证的404页面配置方法：
一、使用路由miss()方法定义兜底响应（推荐用于ThinkPHP 6.x）
该方法在所有路由规则均未匹配时触发，是ThinkPHP 6官方推荐的404处理方式，不依赖异常类，直接由路由层控制，稳定性高。
1、打开项目根目录下的route/app.php文件。
2、确保所有Route::get()、Route::post()等具体路由定义均已写入，miss()必须置于所有显式路由规则之后。
3、在文件末尾添加以下代码：
Route::miss(function () {<br> return response()->view('public/404', [], 404);<br>});
4、在resources/views/public/（或view/public/）目录下创建404.blade.php或404.html模板文件。
5、确认config/app.php中'url_route_must' => true已启用，否则未匹配URL可能绕过路由层。
二、配置TMPL_EXCEPTION_FILE参数（适用于ThinkPHP 3.2/5.x早期版本）
该方式通过框架异常模板机制捕获未捕获的控制器/操作异常，适用于未启用严格路由模式的老项目，对空控制器和空操作均有效。
1、编辑Conf/config.php（TP3.2）或config/template.php（TP5.x）。
2、添加或修改配置项：'TMPL_EXCEPTION_FILE' => 'Public/404.html'。
3、在Tpl/Public/（TP3.2）或public/（TP5.x）目录下创建404.html文件。
4、注意：此方式仅在发生未捕获的PHP异常时生效，不处理纯路由未匹配场景。
三、定义EmptyController并继承公共基类（适用于ThinkPHP 3.2/5.x）
利用框架的“空控制器”机制，当请求的控制器不存在时自动调用EmptyController；再配合公共基类的_empty()方法，覆盖空操作场景。
1、在app/controller/（TP5.x）或Lib/Controller/（TP3.2）下新建EmptyController.php：
<?php <br>namespace app\controller;<br>use think\Controller;<br>class EmptyController extends Controller<br>{<br> public function _empty()<br> {<br> return $this->fetch('public/404', [], [], 404);<br> }<br>}
2、创建一个公共基类BaseController.php，并在其中定义_empty()方法：
public function _empty()<br>{<br> return $this->fetch('public/404', [], [], 404);<br>}
3、确保所有业务控制器均继承该BaseController而非Controller。
4、必须保证EmptyController命名准确且位于正确命名空间，否则无法触发。
四、Nginx配置排除干扰（部署阶段必需检查）
若以上PHP层配置均生效但浏览器仍显示Nginx默认404页，说明Web服务器在PHP执行前已截获请求并返回错误，需调整Nginx配置以放行未匹配路径给PHP处理。
1、检查Nginx站点配置中是否存在error_page 404指令，例如：error_page 404 /404.html;。
2、注释或删除该行，确保404状态由PHP应用自身生成和返回。
3、检查try_files指令是否误将不存在路径重写为404，例如：try_files $uri $uri/ /index.php?$query_string;应保留，而try_files $uri =404;需移除。
4、修改后执行nginx -t && systemctl reload nginx使配置生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
