ThinkPHP路由域名绑定本地不生效的根本原因是环境配置缺失：需修改hosts文件解析域名，Web服务器（Nginx/Apache）配置对应server_name或VirtualHost，且Nginx必须传递HTTP_HOST和HTTPS参数，禁用PHP内置服务器。
ThinkPHP 路由域名绑定在本地开发时为啥不生效
本地测试时 Route::domain() 绑定的子域名（比如 admin.test）打不开，浏览器直接报 DNS 错误或 404，不是框架问题，是环境没对齐。
根本原因：你的本地机器没把自定义域名解析到 127.0.0.1，Web 服务器（如 Apache/Nginx）也没配置对应 server_name 或 server block，请求压根没进到 ThinkPHP。
- Windows 用户改
C:\Windows\System32\drivers\etc\hosts，加一行：127.0.0.1 admin.test - macOS/Linux 用户改
/etc/hosts，同样加127.0.0.1 admin.test - Nginx 配置里必须有
server_name admin.test;，且 root 指向项目 public 目录 - Apache 需启用
vhost_alias，并配好VirtualHost和ServerName admin.test - 别用 PHP 内置服务器（
php -S）跑域名绑定——它不支持 Host 头路由，Route::domain()在里面永远不触发
线上服务器配置 domain 绑定后 500 错误或跳默认路由
常见于 Nginx + FPM 环境，错误日志里出现 Undefined index: HTTP_HOST 或路由始终走 index，本质是 FastCGI 参数没传全。
ThinkPHP 的 Route::domain() 依赖 $_SERVER['HTTP_HOST']，而很多精简版 Nginx 配置漏了 fastcgi_param HTTP_HOST $http_host; 这行。
立即学习“PHP免费学习笔记（深入）”；
- 检查 Nginx 的
fastcgi_params或站点配置中是否包含：fastcgi_param HTTP_HOST $http_host; - 如果用了
try_files，确保 rewrite 规则没覆盖原始 Host 头（比如写成try_files $uri /index.php?$query_string是安全的；但若强行重写为/index.php?_url=...又没透传 Host，就会丢掉域名信息） - 阿里云轻量应用服务器、腾讯云 CVM 默认 Nginx 模板常删掉这一行，手动补上即可
- Apache 用户注意
mod_rewrite开启状态，且.htaccess中不能用RewriteCond %{HTTP_HOST}做二次判断干扰框架逻辑
多个 domain 绑定共存时 route:list 不显示或冲突
php think route:list 默认只输出主域名（app.domain）下的路由，其他 Route::domain() 定义的子域路由不会列出来，不代表没注册成功。
更麻烦的是：如果两个 domain 绑定用了相同路径前缀（比如都定义了 admin/），ThinkPHP 会按注册顺序匹配，后注册的被前一个吞掉——它不校验 domain 是否真正命中。
- 调试时用
var_dump(Route::getRules())查看完整规则数组，确认 domain 键下是否有对应子数组 - 避免在不同 domain 下定义完全相同的路由表达式（如
'admin/index'），哪怕 controller 不同，也建议加 domain 特征前缀（如'admin-v1/index'） - 使用
Route::domain('api', function () { ... })时，闭包内所有路由自动带上 domain 上下文，但不要在里面再嵌套Route::domain() - TP6.1+ 支持
Route::domain(['api', 'admin'], function () {...})批量绑定，比写两次更稳
HTTPS 环境下 domain 绑定跳转异常或混合内容警告
当域名绑定了 HTTPS，但部分资源（CSS/JS）仍通过 HTTP 加载，浏览器会拦截；更隐蔽的问题是：Nginx 把 HTTPS 请求转给 PHP-FPM 时，$_SERVER['HTTPS'] 可能还是空，导致 Url::build() 生成 HTTP 链接。
这不是 ThinkPHP 的 bug，是反向代理链路中协议信息丢失。
- Nginx 配置里加：
fastcgi_param HTTPS on;（仅限真实 HTTPS 终结点） - 如果用了 CDN 或 WAF（如 Cloudflare），需加：
fastcgi_param HTTPS $http_x_forwarded_proto;并确保 CDN 设置了X-Forwarded-Proto: https - TP6 中可在
config/app.php设置'https' => true强制 URL 生成走 HTTPS，但仅适用于全站 HTTPS 场景 - 别在域名绑定路由里硬写
http://协议头，一律用相对协议//或让框架生成
域名绑定本身不复杂，难的是每层环境（DNS、Web Server、PHP SAPI、CDN）都要把 Host 和协议信息原样透传过去。少一环，Route::domain() 就变成摆设。
