thinkphp 404 必须用 route::miss() 接管，因路由未匹配不触发异常类；需在 route/app.php 末尾添加带 404 状态码的响应，避免通配路由拦截，并确保 web 服务器重写生效、public 为根目录。
ThinkPHP 的 404 页面不能靠「异常类」或「错误模板」一招兜底，必须用 Route::miss() 主动接管路由未匹配场景——这是最可靠、最可控的方式。
为什么不用 exception_handle 或 http_exception_template？
因为「页面找不到」本质不是 PHP 异常，而是路由层判定无匹配规则后直接返回 HTTP 404 响应。此时：
-
exception_handle类完全不触发（它只捕获throw出来的异常） -
http_exception_template配置仅对HttpException子类有效（如手动throw new HttpException(404)），对真实路由 404 无效 - 开启
url_route_must => true后，所有请求都必须命中某条路由，否则走miss
如何正确定义 Route::miss？
在 route/app.php 文件末尾添加（必须放在所有 Route::get/Route::post 之后）：
- 基础写法：
Route::miss(function () { return view('public/404'); }); - 带状态码（推荐）：
Route::miss(function () { return response()->view('public/404', [], 404); }); - 跳转到控制器方法：
Route::miss('error/miss');（需确保该方法存在且返回视图或响应） - 多应用模式下，每个应用的
route/app.php都要单独配
404 模板里要注意什么？
通过 view() 渲染的 404 页面默认不注入 $request 或 $app，但你可以显式传参：
- 传递当前 URL 和 IP：
view('public/404', ['url' => request()->url(), 'ip' => request()->ip()]) - 避免在模板中调用
url()辅助函数——路由未匹配时可能报错，改用绝对路径或硬编码链接 - 禁止执行数据库查询、远程请求等耗时操作，保持响应轻量
- 不要依赖
$think_version等调试变量，生产环境可能被禁用
常见失效原因排查
如果写了 Route::miss 却仍看到 Nginx/Apache 原生 404，说明请求根本没进框架：
- 检查 Web 服务器是否启用重写：Nginx 要有
try_files $uri $uri/ /index.php?$query_string;，Apache 要开启AllowOverride All并确认.htaccess生效 - 确认
public/是网站根目录，不是项目根目录 - 检查
config/app.php中'url_route_must' => true是否开启（TP6 推荐） - 删除通配路由（如
Route::any('[:all]', ...)），它会拦截所有未匹配请求，让miss失效
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
