ThinkPHP控制器方法不能直接调用，必须通过路由分发；手动new控制器会绕过框架生命周期，导致依赖注入、中间件、Hook等全部失效，$this->request为null，视图、session、日志等功能异常。
ThinkPHP控制器方法不能直接调用，必须走路由分发；手动 new 控制器再调用方法会绕过框架生命周期，导致依赖注入、中间件、Hook 全失效。
控制器方法为什么不能像普通函数一样直接调用
ThinkPHP 的控制器不是工具类，它的实例由 think\App 在请求生命周期中统一创建，自动注入 Request、Response、配置、中间件等上下文。如果手动 new IndexController() 再调用 index()，$this->request 是 null，$this->assign() 会报错，模板渲染、日志记录、异常处理全挂掉。
常见错误现象：Call to a member function param() on null、Undefined property: app\controller\Index::$app、视图变量不生效、session 丢失。
- 使用场景：想在 A 方法里复用 B 方法逻辑（比如权限校验、数据组装）
- 正确做法是把可复用逻辑抽成独立服务类或模型方法，而不是跨动作调用
- 参数差异：控制器方法默认接收 HTTP 请求参数，而服务类方法可以按需定义参数类型和默认值
想复用逻辑？优先用 Service 层或 Trait
ThinkPHP 官方推荐将业务逻辑下沉到 app\Service 或 app\Common 目录，控制器只负责调度和协议转换。
立即学习“PHP免费学习笔记（深入）”；
示例：把用户信息组装逻辑从 ProfileController::detail() 拆出来：
namespace app\Service;
class UserService
{
public function formatUserProfile(array $raw): array
{
return [
'id' => $raw['id'],
'name' => htmlspecialchars($raw['name']),
'avatar' => $raw['avatar'] ?: '/default.png',
];
}
}
然后在控制器里调用：
$user = (new \app\Service\UserService())->formatUserProfile($data);
- 避免在控制器里写
import或Loader::import手动加载类 - 推荐用容器获取：
app()->make(\app\Service\UserService::class)->formatUserProfile($data)，便于后期替换实现 - 不要在 Service 类里直接调用
input()或session()，应由控制器传入所需数据
实在要“调用另一个动作”，用 redirect 或 request 模拟
极少数场景（如多步骤表单跳转、前后端分离下的内部重定向），需要让当前请求“变成”另一个动作的执行结果。这时不能调方法，但可以用框架提供的合法方式转发：
- 前端跳转：用
redirect('@index/user/profile')，触发完整新请求（URL 变、状态码 302） - 服务端内部转发（不改变 URL）：用
request()->action('profile')->controller('User')->dispatch()，但注意这仍会重建控制器实例，且部分中间件可能重复执行 - 绝对不要用
call_user_func_array([$controller, 'method'], $args)—— 这等于裸奔，框架保护全部失效
性能影响：内部 dispatch() 会重新走路由解析、中间件栈、初始化流程，比直接调方法慢 3–5 倍，仅限必要时用。
调试时误调控制器方法的典型坑
在命令行或单元测试里写 (new IndexController())->index() 看似能跑通，是因为 CLI 环境下部分依赖（如 Request）被框架兜底为 mock 实例；但一上线就崩，因为 HTTP 环境下这些 mock 不存在。
- 错误现象：
Class 'think\Request' not found（没引入命名空间）、Undefined index: SERVER_NAME（$_SERVER 为空） - 兼容性影响：TP6.0+ 默认关闭自动加载控制器构造函数中的依赖，手动 new 会导致
$this->app为 null - 安全风险：绕过中间件后，CSRF 校验、登录态检查、IP 限流全失效
真正可靠的控制器测试方式是用 think\testing\http 发起模拟 HTTP 请求，走完整链路。
