控制器找不到的根源是框架未识别而非代码错误，需依次检查路径规范、命名空间与继承关系、多应用扩展注册、缓存与自动加载、url及路由匹配五方面。

控制器找不到，多数不是代码写错了，而是框架没“看见”它——路径、命名、缓存、扩展注册这四步卡住一个就会报错。

检查控制器文件和命名规范

确保控制器文件真实存在，且严格符合以下要求：

• 文件路径为 app/controller/控制器名.php（如访问 /index，对应 app/controller/Index.php）
• 文件名与类名完全一致，首字母大写，无下划线或小写混用（Index.php → class Index）
• 命名空间必须是 app\controller，不能漏掉 app\ 或写成 App\Controller
• 类需继承 think\controller（注意不是 think\Controller，后者在 TP8 中已弃用）

确认多应用模式已正确启用

若使用多应用（通过 topthink/think-multi-app），仅安装扩展还不够：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 执行命令 php think service:discover，让框架识别并注册该扩展的服务
• 若执行后仍无效，检查 vendor/composer/installed.json 中对应扩展的 extra.think.services 是否为空；若为空，需手动将服务类路径补入 runtime/services.php
• 多应用下每个子应用的配置（如路由、视图）需单独设置，全局 config/app.php 不生效

清空缓存并验证自动加载

ThinkPHP 会缓存类映射和路由，修改后不清理就容易“认旧不认新”：

• 删除 runtime/ 目录全部内容，或运行 php think clear
• 检查控制器类是否能被 PHP 正确加载：在命令行执行 php -a，输入 var_dump(class_exists('app\controller\Index'));，返回 bool(true) 才算通过
• 若返回 false，运行 php think optimize:autoload 刷新 Composer 自动加载

核对访问 URL 和路由规则

URL 写错或路由未匹配，也会表现为“控制器不存在”：

• 默认 URL 格式为 域名/应用名/控制器/方法，多应用下“应用名”不可省略（如 /admin/index/index）
• Linux 服务器严格区分大小写，/Index/index 和 /index/index 是两个不同路径
• 若启用了路由，检查 route/app.php 是否覆盖了该请求；可临时注释所有自定义路由，测试默认规则是否恢复
• Apache 用户确认 .htaccess 生效，Nginx 用户检查是否配置了正确的 try_files

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！