ThinkPHP多应用模式下域名绑定需在入口文件用App::bind()实现，config/app.php的domain_bind无效；路由、静态资源路径、命名空间须与应用目录严格对应，Nginx须统一指向public/且runtime可写。
多应用模式下域名绑定模块失败，app.php 配置不生效
ThinkPHP 多应用模式本身不支持直接通过域名自动切换应用，所谓“域名区分模块”是常见误解——模块（module）和应用（app）在 TP6+ 是两个层级：模块属于单个应用内划分，而多应用是多个独立 app 目录并存。真正能按域名路由到不同应用的，必须靠入口文件或路由调度层控制。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认你用的是 TP6.1+，且已启用多应用模式（
app_multi= true，default_app可留空） - 不要在
config/app.php里写'domain_bind' => ['a.com' => 'admin']—— 这是旧版单应用的写法，TP6 多应用下该配置被忽略 - 正确做法是：在
public/index.php入口处手动读取$_SERVER['HTTP_HOST']，再调用think\App::bind()绑定应用名，例如：if ($_SERVER['HTTP_HOST'] === 'admin.example.com') { \think\App::bind('admin'); } - 注意：绑定必须在
App::run()之前，且不能晚于require __DIR__ . '/../vendor/autoload.php';之后
子域名解析到不同应用时，route.php 路由不匹配
即使应用成功绑定，子域名下的路由仍走默认应用的 route.php，因为 TP 默认只加载当前绑定应用下的路由文件，但若入口没显式指定应用路径，框架会 fallback 到 app/route.php（即默认应用），而不是 app/admin/route.php。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确保每个应用目录下都有独立的
route.php（如app/admin/route.php），且内容以use think\facade\Route;开头 - 检查
app/admin/config/app.php中的'default_route' => true是否为 true；若为 false，需手动在app/admin/route.php中调用Route::get()等注册 - 调试时可在
app/admin/route.php开头加dump('admin route loaded');，确认是否被执行 - 避免在根
app/route.php里写全局路由规则，它只对默认应用生效，其他应用不会继承
部署后静态资源 404，public/static/ 路径错乱
多应用模式下，静态资源默认仍从 public/static/ 加载，但如果你把不同应用的前端资源分开存放（比如 public/static/admin/ 和 public/static/api/），模板里用 static('css/app.css') 就会出错——这个函数不感知当前应用，始终拼接根 static/ 下的路径。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要依赖
static()自动推导，改用绝对路径或应用前缀：<link rel="stylesheet" href="/static/admin/css/app.css">
- 如果必须动态生成，可在应用配置中加自定义项，如
app/admin/config/app.php里设'static_prefix' => '/static/admin'，模板中用config('app.static_prefix').'/css/app.css' - 切勿将不同应用的 JS/CSS 混放在同一
public/static/目录下却不加命名区分，容易引发缓存覆盖和版本冲突 - Nginx 配置需确保所有域名都指向同一
public/目录，否则子域名可能找不到index.php
上线后部分请求返回 500，日志显示 ClassNotFoundException: app\admin\controller\Index
这是最典型的命名空间与目录结构不一致导致的问题。TP6 多应用要求控制器类名严格匹配路径：应用名 + 控制器名，且命名空间必须为 app\{app_name}\controller。一旦服务器大小写敏感（Linux），而本地开发用 Windows，就极易因大小写不符触发类找不到。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查控制器文件路径是否为
app/admin/controller/Index.php（不是index.php或INDEX.PHP） - 确认类声明是
namespace app\admin\controller;，不是app\Admin\controller或app\administrator\controller - 清空
runtime/下所有缓存（cache/、log/、route/），TP 的路由和类映射缓存在部署后未更新会导致旧路径残留 - 在生产环境开启
app_debug= false 前，务必先在测试环境用php think build生成类映射，避免运行时动态加载失败
public/，以及 runtime/ 权限是否让 Web 用户可写——这两点不满足，前面所有配置都白搭。 
