ThinkPHP 8.0路由与验证必须严格按执行链路配置：路由需分三层顺序定义并加正则约束；注解路由须安装扩展、初始化且配置扫描路径；验证器场景需显式声明字段白名单并链式调用；路由缓存需关闭调试并带参数重建。
ThinkPHP 8.0手册不是翻着看的文档堆，而是必须按执行链路拆解使用的操作指南：路由定义顺序错一位、验证器场景漏一个字段、注解没初始化——接口立刻404或静默跳过校验，根本不会报错提示你哪步错了。
路由定义顺序必须严格分层
第一步：打开 app/route/app.php，把所有不含变量的完整路径规则移到文件最顶部。例如：
Route::get('user/profile', 'User/profile');
Route::get('admin/login', 'Admin/Login/index');
Route::get('api/status', 'Api/Status/check');
第二步：紧接其后，写含单一变量的规则，但必须确保它们不覆盖更具体的子路径。比如 【user/:id/edit 必须排在 user/:id 之后】，否则访问 /user/123/edit 时，框架会把整个字符串 "123/edit" 当作 :id 的值，控制器收不到 edit 段。
第三步：把带多级变量或通配符的规则（如 user/*、article/:year/:month/:slug）放在最后。Route::miss() 语句也必须放在这里——它只在全部已注册规则遍历完仍未匹配时才触发。
立即学习“PHP免费学习笔记（深入）”；
变量规则必须加正则约束，不能靠默认
方法一：用括号内联正则替代默认:id
Route::get('user/:id([0-9]+)', 'User/read');
Route::get('post/:year([0-9]{4})/:month([01][0-9])', 'Post/archive');
方法二：用 ->pattern() 显式声明局部约束
Route::get('detail/:token', 'Index/detail')->pattern(['token' => '\S+']);
这一步很关键：默认 :token 遇到 URL 中的 / 就停，而 \S+ 能吞掉 Base64 编码里的斜杠；但别用 .*，它会一路吃到 URL 末尾，导致后续路由段丢失。
方法三：对可选变量也加约束，防止空值或非法字符穿透
Route::get('search[:q?]', 'Search/index')->pattern(['q' => '[\w\u4e00-\u9fa5\-_]+']);
中文支持靠这个正则生效，前提是 config/route.php 中 url_html_suffix 为 false，否则 .html 后缀会截断请求。
注解路由启用前必须完成三件事
第一件事：执行 composer require topthink/think-annotation 安装扩展。TP8.0 不内置注解能力，漏装就永远看不到 @Route 注解。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
第二件事：在 app/bootstrap.php 最底部添加 AnnotationRoute::init();。config/annotation.php 里 'route' => ['enable' => true] 只控制解析开关，不调 init()，控制器上的注解永远不会被读取。
第三件事：检查控制器类是否在正确命名空间下。默认只扫描 app\controller，多应用如 admin 必须手动在 config/annotation.php 的 'controllers' 数组中加入 'app\admin\controller'，路径末尾的 \controller 不能省，且必须用双反斜杠转义。
验证器场景必须显式声明字段白名单
生成验证器类后，立刻检查 app/validate/UserValidate.php 的 $scene 属性是否完整列出各场景字段：
protected $scene = [
'register' => ['name', 'email', 'mobile', 'password'],
'login' => ['email', 'password'],
'edit' => ['name', 'email']
];
漏写字段 = 不校验 = 也不保证它存在。比如 edit 场景没写 mobile，那即使用户 POST 了 mobile 字段，它也不会被校验；但如果你后续代码写了 $data['mobile']，就会直接报 PHP Notice。
调用时必须链式执行 scene() → check()：
$validate = new UserValidate();
if (!$validate->scene('register')->check($data)) {
return json(['error' => $validate->getError()]);
}
路由缓存必须按状态清除与重建
APP_DEBUG=true 时，路由缓存形同虚设。不能只看 runtime/cache/route.php 是否存在，得在控制器里 dump(\think\App::debug()) 确认实际运行状态。
彻底清除缓存的唯一可靠方式是执行：
php think clear:route
重建缓存前，必须确保 APP_DEBUG=false 且 runtime/ 目录可写；若使用注解路由，重建命令必须加 --annotation 参数：
php think route:cache --annotation
不加这个参数，新控制器里的 #[Route] 注解会被完全忽略。
