域名绑定后访问不到控制器，需确认Route::domain()是否生效：必须在路由注册阶段调用、避免顺序错乱、注意数组语法、区分模块绑定与控制器绑定、慎用crossDomainRule()、.com.cn等特殊后缀须配置url_domain_root并清缓存。
域名绑定后访问不到控制器？先确认 Route::domain() 是否生效
直接用 Route::domain('admin', 'admin') 绑定后，访问 http://admin.example.com 却 404 或跳回首页，大概率是路由没加载或顺序错乱。ThinkPHP 的域名绑定必须在路由注册阶段完成，且不能被后续的通用路由覆盖。
常见错误包括：
- 把
Route::domain()写在了Route::get()或Route::rule()之后，导致绑定未被识别 - 在
route.php中混用了闭包写法和数组写法，但没注意闭包内必须显式调用Route::rule()等方法 - 用了
Route::domain(['a','b'], ...)却漏写了数组语法的括号，写成Route::domain('a','b', ...)—— 这会直接报错：「Too many arguments」
绑定到模块 vs 绑定到控制器，路径规则完全不同
这是最容易混淆的点：Route::domain('admin', 'admin') 和 Route::domain('admin', 'index/admin') 表现差异极大，根本不是“多写一个斜杠”的事。
前者（绑定模块）意味着整个 admin 模块被提升为根入口，URL 路径从 /admin/index/index 缩减为 /index/index；后者（绑定控制器）则彻底跳过模块层，http://admin.example.com 会直接映射到 app\index\controller\Admin 的 index 方法，且 URL 中不再出现 index 或 admin 字样。
立即学习“PHP免费学习笔记（深入）”；
关键区别：
- 绑定模块：
Route::domain('admin', 'admin')→ 访问http://admin.example.com/user/list对应app\admin\controller\User::list - 绑定控制器：
Route::domain('admin', 'index/admin')→ 访问http://admin.example.com就触发app\index\controller\Admin::index，加路径如/login则需额外配置路由规则 - 若想让
http://admin.example.com直达后台登录页，推荐用控制器绑定 + 默认方法，而不是改default_module配置 —— 后者会影响所有未匹配域名的请求
crossDomainRule() 不是万能的，慎用于生产环境
文档里提到的 crossDomainRule() 看起来很诱人：写一次路由，全站域名都生效。但实际中它只对「分组路由」有效，且不支持跨子域名的独立参数约束（比如 blog.example.com 要校验 id 为数字，而 api.example.com 不校验）。
更现实的问题是调试困难：一旦启用，你无法通过 php think route:list 清晰看到该规则到底绑定了哪些域名，日志里也难定位是哪个域名触发了这条规则。线上出问题时，往往得临时注释掉它再逐个测试。
建议只在以下场景考虑使用：
- 多个测试子域名（dev1.test、dev2.test）共享同一套 API 路由，且无差异化逻辑
- 静态资源域名（static.example.com）需要透传全部
/assets/xxx到某个控制器，且不涉及权限判断 - 明确知道当前项目不会增加新域名，且团队已约定禁止在闭包内写条件分支
特殊域名后缀（如 .com.cn）必须配 url_domain_root
如果你的域名是 example.com.cn，直接写 Route::domain('example.com.cn', 'admin') 是无效的 —— ThinkPHP 默认只截取最后一级（cn），导致域名解析失败，绑定自然不生效。
必须在 config/app.php 中显式声明：
'url_domain_root' => 'example.com.cn',
否则框架会把 example.com.cn 当作 com.cn 处理，而 com.cn 显然不是你注册的合法子域名。这个配置项没有默认值，不写就是空字符串，不写就必然出问题。
顺带提醒：改完这个配置后，务必清空 runtime/cache/ 下的路由缓存，否则旧缓存会持续干扰新规则。
