必须开启url_domain_deploy配置，否则url()默认只生成当前请求域名下的链接；route::domain()内需重写全部路由，nginx须透传http_host头。
ThinkPHP5 域名绑定后 url() 生成的地址还是主域名（比如 www.example.com），而不是你期望的 api.example.com —— 这不是 bug，是默认行为，必须显式开启域名部署支持。
url() 不带绑定域名？检查 url_domain_deploy 配置
即使你在 route/app.php 中用 Route::domain('api.example.com', ...) 正确绑定了域名，url('api.User/read', ['id' => 123]) 默认仍会生成当前请求所在域名下的链接（比如从 www.example.com 发起的请求，就拼出 www.example.com/api/user/123）。
要让它按路由所属域名生成链接，必须在 config/route.php 中启用：
return [
'url_domain_deploy' => true,
'url_html_suffix' => '', // 避免拼出 .html 后缀干扰子域路径
];
- 不设
url_domain_deploy→url()完全无视域名绑定，只看当前请求的$_SERVER['HTTP_HOST']
url_html_suffix 若为 <code>'.html'，可能生成api.example.com/v1/user/123.html，而你的路由规则没配后缀，导致 404- 该配置只影响
url()辅助函数，不影响路由匹配本身
Route::domain() 闭包里漏写路由？404 的真正原因
访问 http://api.example.com/v1/user 返回 404，但 http://www.example.com/index/index 能通 —— 这说明全局路由还在跑，而 api.example.com 下根本没注册任何规则。
Route::domain() 是独立作用域，不是“叠加”或“继承”。你原来写在外部的 Route::rule()、Route::resource() 等，对这个域名完全不可见。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 必须把所有该域名下需要的路由，全部重写进闭包内：
Route::domain('api.example.com', function ($r) { $r->get('v1/user', 'api.User/index'); }); - 闭包参数是
$r（think\Route实例），别错写成Route::get()（那是静态调用，会注册到根域） - 泛域名
Route::domain('*')同样要显式写$r->get()，不能只靠Route::rule() - 如果用了
Route::any()或Route::resource()，也得放在闭包里，否则不生效
Nginx 没透传 Host 头？本地和线上都可能翻车
Route::domain() 匹配依赖 $_SERVER['HTTP_HOST']。如果 Nginx 没把这个头传给 PHP-FPM，框架拿到的是空值或 localhost，域名路由直接跳过。
检查你的 Nginx 配置，在 fastcgi_params 或站点 server 块中，必须有这一行：
fastcgi_param HTTP_HOST $http_host;
- 线上常见于阿里云/腾讯云精简模板，这行被删了，手动补上即可
- 如果用了 HTTPS 反代，还需加
fastcgi_param HTTPS on;（或根据实际变量判断） - 本地开发别用
php -S，它根本不解析 Host 头，Route::domain()在里面永远不触发 - Apache 用户要确认
mod_rewrite开启，且.htaccess没用RewriteCond %{HTTP_HOST}干扰原始头
调试时看不到子域名路由？别信 php think route:list
php think route:list 默认只显示主域名（app.domain 配置值）下的路由，Route::domain() 定义的子域路由不会列出来 —— 这不代表它们没注册成功。
真要看全量规则，直接在代码里 dump：
var_dump(\think\Route::getRules()['domain']);
- 如果输出为空数组，说明
Route::domain()根本没执行（检查是否写在route/app.php，而非config/route.php或控制器里） - 如果输出里有
'api.example.com'键，但其值为空，说明闭包里没写任何路由规则 - 如果键名是
'*'却没看到预期路由，说明泛域名闭包里漏掉了$r->post()等显式方法调用
最常被忽略的点：域名路由不是“配完就自动生效”，它依赖三件事同时成立——配置文件位置正确、url_domain_deploy 开启、Nginx 透传 Host 头。少一个，url() 就错，404 就来。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
