ThinkPHP 5 绑定域名后控制器报错主因是命名空间与文件路径不匹配，需在 route/app.php 顶部用 Route::bind('admin') 全局绑定模块，确保类文件位于 app/admin/controller/Index.php 且声明 namespace app\admin\controller;。
ThinkPHP 5 绑定域名后控制器报错，绝大多数情况不是路由没写对，而是命名空间和文件路径根本没对上——框架连类文件都加载不进来，自然找不到控制器。
为什么 domain() 绑定后还报 Class not found
ThinkPHP 5 的 domain() 只负责路由分发，不切换应用上下文。它仍按默认命名空间（如 app\controller）去加载控制器，哪怕你绑了 admin.example.com，它也不会自动去找 app\admin\controller 下的类。
- 典型错误现象：
Class app\controller\Index does not exist，但你实际把控制器放在app/admin/controller/Index.php - 根本原因：没配
bind模块绑定，或bind配置位置不对（必须在route/app.php开头，不能塞在闭包里） -
domain('admin.example.com')->group(['prefix' => 'admin'], function () { ... })这种写法只是加了个前缀，不是模块切换；get('index', 'index/index')仍会去app\controller\Index找
bind() 必须写在 route/app.php 顶部
bind() 是全局模块绑定指令，只在路由加载初期生效，一旦路由规则开始解析，它就不再起作用。
- 正确写法：
use think\Route; Route::bind('admin'); Route::domain('admin.example.com', function () { Route::get('index', 'index/index'); }); - 错误写法：把
Route::bind('admin')放进domain()闭包里，或放在return [];后面 - 绑定后，所有该域名下的控制器类名前缀自动变成
app\admin\controller，对应文件路径为app/admin/controller/Index.php - 若同时用了子目录模块（如
app/admin），确保app/admin/config.php中'app_namespace' => 'app\admin'已配置，否则命名空间仍 fallback 到app\controller
控制器文件路径与命名空间必须严格一致
ThinkPHP 5 虽未强制 PSR-4，但模块绑定后自动加载逻辑依赖路径推导，大小写、目录层级、类名拼写任一出错都会中断加载。
立即学习“PHP免费学习笔记（深入）”；
- 控制器文件必须放在
app/admin/controller/Index.php（注意是小写controller目录） - 类声明必须是
namespace app\admin\controller;，末尾有反斜杠，不能漏掉admin或写成App\Admin - 类名必须首字母大写且与文件名完全一致：
class Index对应Index.php，不能是index.php或IndexController.php - Linux 服务器上尤其要注意：本地开发用
index.php能跑通，部署后直接Class not found
调试时别跳过 dump(Route::getRule())
绑定是否生效，不能只看浏览器 404，得确认路由规则是否真被注册进去。
- 临时在
route/app.php末尾加一行：dump(Route::getRule());exit; - 访问任意 URL，查看输出中是否有你定义的
domain条目，以及其option.bind是否为admin - 如果没出现，说明
bind()没执行，或domain()写法有语法错误（比如漏了闭包、括号不匹配） - 如果出现了但
option.bind是空，说明bind()被覆盖或写在了错误位置
真正卡住人的从来不是“怎么写”，而是“写在哪”和“大小写是否一致”——这两个点不验证，光调路由逻辑只会越调越迷。
