ThinkPHP 6 不支持模块自动绑定域名，必须在 route/domain.php 中用 Route::domain() 定义域名分组并 require 对应模块路由文件，同时确保 config/app.php 中 'url_domain_deploy' => true。
ThinkPHP 6 如何配置多模块独立域名
直接说结论：ThinkPHP 6 不支持「模块自动绑定域名」，必须通过 route/domain.php 手动定义域名路由分组，再在分组内导入对应模块的路由文件。别信网上那些“在 app.php 配置 domain_bind 就能生效”的说法——那是 TP5.0 的旧写法，TP6 已移除该机制。
典型错误现象：Route::domain('admin.example.com')->group(...) 写了但访问 404，或者所有请求都进默认模块，域名没起作用。根本原因是：没有显式调用 require 对应模块的路由定义，或未启用域名路由解析（url_domain_deploy 关闭）。
- 确保
config/app.php中'url_domain_deploy' => true（默认已开启，但检查下更稳妥） - 所有域名路由定义必须放在
route/domain.php，不能写在route/app.php或模块自己的route.php里 - 每个域名分组内需用
->group(...)+require显式加载模块路由，例如：Route::domain('api.example.com')->group(function () { require __DIR__ . '/api.php'; }); - 模块路由文件（如
route/api.php）里定义的路由，会自动挂载到该域名下，无需加前缀
为什么 Route::domain() 分组里不能直接写路由规则？
可以写，但不推荐。因为模块路由往往较多、含中间件、资源路由等复杂结构，硬塞进 domain.php 会导致维护困难、无法复用模块内路由逻辑（比如 api.php 里已定义的 Route::resource()），也违背模块自治原则。
更关键的是：TP6 的路由加载顺序是「先加载 domain.php，再按需加载分组内 require 的文件」。如果在分组里直接写 Route::get('user', ...)，它确实会生效；但一旦你后续在 api.php 里也定义了 /user，就会触发路由冲突，且后者不会覆盖前者——TP6 不做合并，只按加载顺序注册，后注册的同名路由会报错或静默忽略。
立即学习“PHP免费学习笔记（深入）”；
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 推荐做法：分组内只做
require，把具体路由全部收口到对应模块的route/*.php文件中 - 若必须动态生成路由（如多租户子域名），可用
Route::domain('*')+Request::domain()在闭包里判断并require不同文件 - 注意：通配符域名（
*）需配合 Nginx/Apache 的泛域名解析，且不能与精确域名共存于同一分组
子域名识别失败？检查 Nginx 和 url_html_suffix
常见现象：Nginx 已配置 server_name api.example.com;，PHP 里 Request::domain() 却返回 example.com 或空字符串。大概率是 Nginx 没透传 Host 头，或 ThinkPHP 把带端口的 Host 当成非法域名过滤了。
TP6 默认用 $_SERVER['HTTP_HOST'] 解析域名，而 Nginx 反向代理时若没设置 proxy_set_header Host $host;，可能传过来的是上游地址。另一个隐蔽坑是：当启用了 url_html_suffix（如 '.html'），且访问地址是 https://admin.example.com/index.html，TP6 会尝试从 index.html 里截取域名，导致解析失败。
- Nginx 配置必须包含：
proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr;
- 开发时临时关闭
url_html_suffix（设为''）可快速验证是否为此原因 - 调试用：
var_dump($_SERVER['HTTP_HOST'], Request::domain(), config('app.url_domain_deploy'));
跨模块共享中间件和全局过滤器怎么处理？
域名分组本身不隔离中间件。但如果你在 api.php 里写了 Route::middleware(['cors'])，这个中间件只对 api.php 内定义的路由生效；而 admin.php 里的路由默认不走 cors。这不是 Bug，是设计使然——路由分组的中间件作用域仅限于该分组内加载的路由。
真正容易被忽略的是「全局中间件」和「路由中间件」的叠加行为。例如你在 app/middleware.php 里注册了 CheckAuth，又在 admin.php 分组里加了 ->middleware(['check_permission'])，那么访问 admin.example.com 下任何路由，会先执行 CheckAuth，再执行 check_permission。但如果某个路由同时匹配多个分组（比如泛域名 + 精确域名），中间件会重复执行。
- 跨模块通用中间件，统一放
app/middleware.php；模块特有中间件，在对应route/*.php内用->middleware()绑定 - 避免在
domain.php分组上直接绑中间件（如Route::domain(...)->middleware([...])），它会对整个分组生效，但无法控制执行顺序，易与全局中间件冲突 - 调试中间件执行顺序：在中间件
handle()里加echo get_class($this) . PHP_EOL;，看输出顺序
最麻烦的不是配置，而是域名路由和模块命名空间、控制器路径的耦合。比如 admin.example.com 对应 app\admin\controller，但 TP6 不自动映射，全靠你在 admin.php 里写的 Route::get('user', 'User/index') 显式指向。漏写一个，就 404——这种隐式依赖，上线前务必用 php think route:list 全量核对。
