ThinkPHP5中Route::domain()不生效的根本原因是未开启url_domain_deploy配置，必须在config/app.php中显式设置'url_domain_deploy' => true，否则该路由规则会被静默忽略。
ThinkPHP5中Route::domain()为什么经常不生效
根本原因是没开 url_domain_deploy 配置。TP5 默认关闭域名部署，只开 url_route_on 不够。必须在 config/app.php 里显式设置：'url_domain_deploy' => true，否则 Route::domain() 定义的规则直接被忽略，连报错都没有，静默 fallback 到默认路由。
常见错误现象包括：子域名访问时始终进 index 模块、URL 生成不带域名、调试时发现路由日志里压根没匹配到 domain 规则。
- 配置项名是
url_domain_deploy，不是route_domain_bind（那是 TP6 的） - TP5 不支持泛域名（如
*.example.com），只能写死完整子域名或主域名 - 如果用了多应用模式，
Route::domain()会和应用目录名冲突，优先走应用匹配，此时 domain 绑定可能被跳过
绑定到模块 vs 绑定到路由分组，怎么选
两者底层逻辑完全不同：Route::domain('admin', 'admin') 是「域名 → 模块」的硬跳转，一旦命中，直接绕过所有路由检查，进 admin 模块的默认控制器；而 Route::domain('admin', function(){...}) 是「域名 → 路由分组」，仍走完整路由匹配流程，支持中间件、参数约束、MISS 路由等。
实际项目里，90% 场景该用后者。前者看似简单，但无法定义具体 URL 路径、不能加中间件、URL 生成也不可控。
立即学习“PHP免费学习笔记（深入）”；
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- 绑定到模块适合纯静态入口，比如
admin.example.com全部交给admin模块处理 - 绑定到分组适合需要精细控制的场景，比如
api.example.com/v1/user和api.example.com/v2/user分开定义 - 注意：分组内不能再嵌套
Route::domain()，否则报错
route_config_file 配置多个路由文件时的加载顺序
TP5 支持通过 'route_config_file' => ['home', 'admin', 'api'] 拆分路由配置，但加载是顺序执行的，后加载的规则会覆盖同路径的前序规则 —— 这不是 bug，是设计行为。
比如 home.php 里写了 Route::get('user', 'index/User/index')，admin.php 里又写了 Route::get('user', 'admin/User/index')，那最终生效的是后者。
- 推荐按「通用 → 专用」顺序排列，例如
['common', 'home', 'admin'] - 不要在不同文件里重复定义同一 URL 路径，除非你明确需要覆盖
- 路由缓存命令
php think optimize:route会合并所有文件，所以开发时改了路由要记得清缓存
生成带域名的 URL 时容易漏掉的关键参数
url() 函数默认只拼当前请求域名，哪怕你在 Route::domain('admin', ...) 里定义了规则，它也不会自动补上 admin.example.com。必须手动传 ['domain' => 'admin']，且这个键名必须和 Route::domain() 第一个参数完全一致（大小写敏感）。
示例：url('admin/index/index', [], ['domain' => 'admin']) 才会输出 http://admin.example.com/index/index；漏掉 ['domain' => 'admin'] 就还是当前域名。
- 如果用了
route_domain配置（TP6 方式），TP5 并不识别，强行写会无效 - 模板里用
{:url('index/index', [], ['domain'=>'admin'])}，别省略第三个参数 - APP_DEBUG 关闭后，域名参数错误不会提示，只会静默回退到当前域名，上线前务必测试
真正麻烦的不是写几行 Route::domain()，而是搞清它在哪一层生效、被谁覆盖、URL 怎么生成才带对域名。很多问题其实卡在配置开关没开、参数名写错、或者缓存没清——这些点比语法本身更常导致失败。
