TP5支持domain_bind，但仅限单应用模式；多应用下该配置被静默忽略。需确认未启用app_multi、配置在config/app.php根级、模块目录存在且命名一致，否则绑定失效。
ThinkPHP5 的域名绑定模块缓存失效，不是路由没写对，而是 APP_DEBUG=true 强制跳过所有缓存加载、runtime/ 目录不可写、或 domain_bind 配置被忽略——这三者占了 90% 以上的实际案例。
domain_bind 配置在 TP5 中是否生效？
TP5 支持 domain_bind，但仅限单应用模式；多应用下该配置会被静默忽略。确认你用的是单应用（即没有启用 app_multi），且配置写在 config/app.php 根级，不是 .env 或其他中间层：
-
'domain_bind' => ['admin.example.com' => 'admin']必须是数组，键为完整域名（含端口需显式写出），值为模块名（非应用名） - 模块目录必须存在且命名一致：
application/admin/，否则绑定后找不到控制器，直接 404 - 若同时启用了
url_route_must（强制路由），未定义的域名请求会直接报错，而非 fallback 到默认模块 - 调试时可在
application/admin/controller/Index.php开头加dump('admin module loaded');，访问admin.example.com看是否输出
APP_DEBUG=true 导致域名路由缓存不加载
TP5 在 APP_DEBUG=true 下会跳过 runtime/data/route.php 缓存文件读取，即使你已执行过 php think optimize:route，也完全无效。现象是：域名能解析、入口能进，但所有 Route::rule() 和 Route::domain() 都不触发。
- 在任意控制器中插入：
dump(config('app.app_debug'));，输出true就是问题根源 -
.env中设APP_DEBUG=false不一定生效，最终以config/app.php中'app_debug' => false解析结果为准 - 清理缓存后必须重启 Web 服务（如
nginx -s reload或重启 PHP-FPM），否则旧进程仍持有 debug=true 的运行态
runtime 目录权限异常导致 route.php 生成失败
执行 php think optimize:route 后，runtime/data/route.php 文件不存在或为空，大概率是写入失败。TP5 不报错，只静默跳过。
立即学习“PHP免费学习笔记（深入）”；
- 检查
ls -ld runtime/ runtime/data/，确认 Web 用户（如www-data）有写权限 - 若用 Docker，常见问题是挂载 volume 后容器内 UID 与宿主机不一致，
chown www-data:www-data runtime在启动后失效；应在Dockerfile中加USER www-data - 若项目自定义了
RUNTIME_PATH，运行var_dump(RUNTIME_PATH);确认路径真实指向位置，避免清理了错误目录 - 手动创建空文件测试：
touch runtime/data/test.txt && ls -l runtime/data/，看是否能写入
模板与配置缓存未同步更新
域名绑定成功后页面仍是旧内容，常因模板缓存或配置缓存未刷新，和路由本身无关。
- TP5 模板编译文件默认存在
runtime/temp/，不是runtime/cache/；清缓存必须包含：rm -f runtime/temp/* - 配置缓存（如数据库 host、缓存驱动）存在
runtime/data/config.php，php think clear默认不清理它，需手动删或执行php think clear:config - 若使用了
template.cache_time配置，设为0可强制每次检查源文件修改时间，开发阶段更可靠 - 浏览器缓存干扰：域名切换后，
http://admin.example.com可能被浏览器缓存重定向到www.example.com，用curl -v http://admin.example.com绕过验证
最易被忽略的一点：TP5 的 domain_bind 是在路由注册前由框架自动处理的，它不支持通配符子域（如 *.example.com），也不支持泛域名 fallback；每个要绑定的域名都必须显式列出，漏一个就 404，且不会报错提示。
