tp8的404非异常，route::miss()是唯一可靠处理入口，需置于所有路由后、显式返回404状态码，并确保url_route_must=true、禁用通配路由、nginx无error_page拦截且root指向public目录。
ThinkPHP 8.0 的 404 不是异常，改 app_exception 类或全局异常处理器基本没用——它压根不会触发。
Route::miss() 是唯一可靠入口
TP8 的路由层在所有规则都不匹配时，才走 Route::miss()，这是处理“真 404”的正路。其他方式（比如靠控制器 _empty 或方法 _empty）只覆盖“控制器存在但动作/模块不存在”的子集，漏掉大量场景。
- 必须放在
route/app.php所有Route::get()、Route::post()等之后，否则会被前置路由拦截 - 返回值默认状态码是 200，要显式设为 404：
return response()->view('error/404', [], 404); - 不支持直接在视图里调用
url()辅助函数——路由未匹配，url()可能抛错；建议用绝对路径或硬编码链接 - 若项目启用了多应用模式，每个应用的
route/app.php都得单独加这一行
别碰 Nginx 的 error_page 404
TP8 返回的 404 是 PHP 层响应，但如果 Nginx 配置了 error_page 404，就会跳过 PHP 直接返回自己的静态页，你的 Route::miss() 完全不执行。
- 检查 Nginx 配置（如
vhosts.conf）是否含error_page 404或类似语句，注释或删掉 - 确认
location /块中用了正确的伪静态规则：try_files $uri $uri/ /index.php?$query_string;（TP8 推荐） - 确保
root指向的是public/目录，不是项目根目录；否则/index.php路径会错位
url_route_must 必须为 true
TP8 默认关闭路由强制模式，即 URL 不匹配路由规则时，会退回到 PATH_INFO 解析逻辑，绕过 Route::miss()，导致 404 失效。
- 检查
config/app.php中'url_route_must' => true是否启用 - 禁用通配路由（如
Route::any('[:all]', ...)），它会吞掉所有未命中请求，让miss()永远不触发 - 开发时可临时加日志验证：在
miss()闭包里写file_put_contents('/tmp/miss.log', date('Y-m-d H:i:s')."\n", FILE_APPEND);，看是否真被调用
真正容易被忽略的是：404 视图渲染时，$request 和 $app 不自动注入。想显示当前 URL 或 IP，得手动传参：view('error/404', ['url' => request()->fullUrl(), 'ip' => request()->ip()])；另外，任何数据库查询或远程调用都该从 404 页面里剔除——它不该承担业务逻辑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
