ThinkPHP路由不生效需先开启url_route_on，检查环境配置，确保路由变量名与控制器参数名一致，用正则约束slug，优先使用域名分组处理多语言和子域名，避免缓存及HTTPS混合内容问题。
ThinkPHP 路由不生效？先确认 URL_ROUTE_ON 已开启
默认情况下 ThinkPHP 5.1+ 的路由是关闭的，即使写了 route.php 也完全不起作用。常见现象是访问 /user/123 仍被当成模块/控制器/操作解析，而不是走你定义的路由规则。
必须在 config/app.php 中显式启用：
'url_route_on' => true,
如果使用命令行或 CLI 环境（如队列、定时任务），还需检查 app_debug 和环境配置是否意外禁用了路由——部分部署环境下 app.php 被覆盖，实际加载的是 extra/app.php 或环境专属配置。
用 Route::get() 定义静态路径时，别漏掉闭包参数或控制器方法签名
写 Route::get('article/:id', 'index/Article/read') 看似没问题，但控制器 read() 方法若声明为 public function read($id = null)，而路由变量名是 :id，则能自动注入；但如果写成 public function read($aid)，就不会匹配成功，也不会报错，只是返回 404。
立即学习“PHP免费学习笔记（深入）”；
更稳妥的做法是显式绑定参数名：
Route::get('article/:id', 'index/Article/read')->option(['merge_param' => true]);
- 确保控制器方法参数名与路由变量名一致（
$id对应:id） - 避免在方法中用
input('id')取值——这绕过了路由参数绑定，失去 SEO 路径语义性 - 如果需要兼容旧 URL（如带
?type=new），加->append(['type' => 'new'])可保留查询参数
SEO 友好路径要避开 :id 这类纯数字占位符，改用 :slug + 正则约束
搜索引擎更倾向识别含关键词的路径，比如 /article/how-to-optimize-thinkphp-routing 比 /article/123 权重高。但直接把 slug 当变量传，又容易被恶意构造（如包含 ../ 或 SQL 片段）。
正确做法是限制 :slug 的字符范围：
Route::get('article/:slug', 'index/Article/view')->pattern(['slug' => '\w+-\w+']);
说明：
-
\w+匹配字母、数字、下划线，-允许连字符，排除空格和斜杠 - 数据库查数据时，仍需用
$slug查唯一标识字段（如slug字段），不能直接用它当主键 - 生成链接时统一用
url('index/article/view', ['slug' => $article['slug']])，避免手拼 URL 导致大小写或编码不一致
子域名路由和多语言前缀容易冲突，优先用 domain 分组而非全局规则
想实现 zh.example.com/article/xxx 和 en.example.com/article/xxx，如果在全局路由里写 /:lang/article/:slug，会导致所有请求都强制带 lang，连后台 /admin 也被拦截。
应该用域名分组隔离：
Route::domain('zh.example.com', function () {
Route::get('article/:slug', 'index/Article/view')->pattern(['slug' => '\w+-\w+']);
});
Route::domain('en.example.com', function () {
Route::get('article/:slug', 'index/Article/view_en');
});
注意点：
- 本地测试时修改
hosts文件后，浏览器可能缓存 301 重定向，导致看似“跳转失败”，实际是缓存问题 - HTTPS 环境下子域名证书需覆盖所有用到的域名，否则路由虽生效，页面会因混合内容被拦截
- 不要在分组内重复定义相同路径——ThinkPHP 不会合并，后注册的会覆盖前一个
