ThinkPHP 6+ 中 initialize() 不再自动调用，须改用中间件替代；因控制器变为普通类、无隐式初始化钩子，权限校验、参数过滤等逻辑需迁移至中间件层，按作用域注册并注意变量赋值、请求获取与异常处理方式。
ThinkPHP 6+ 中 initialize() 方法已不再被框架自动调用，直接保留会导致逻辑静默失效 —— 必须改用中间件（Middleware）接管初始化职责。
为什么 initialize() 不再生效
ThinkPHP 6 起彻底移除了控制器基类的自动初始化钩子机制，initialize() 只是普通方法，不会被框架反射调用。常见现象是：权限校验、参数过滤、日志记录等逻辑在控制器里写好了，但实际完全没执行。
根本原因在于 TP6 的请求生命周期重构：控制器实例化时机晚于请求处理链，且不再预留统一入口点。
- TP5.1/5.2 中
initialize()是由think\Controller基类在构造后主动调用 - TP6+ 中控制器只是普通 PHP 类，由容器直接解析，无隐式调用逻辑
- 官方明确将初始化职责移交至中间件层，强调“面向切面”而非“面向继承”
如何用中间件替代控制器初始化逻辑
把原来写在 initialize() 里的代码，提取为独立中间件，并注册到对应路由或全局中间件队列中。关键不是“替换函数”，而是“迁移关注点”。
立即学习“PHP免费学习笔记（深入）”；
例如原 TP5 控制器中：
protected function initialize()
{
$this->checkLogin();
$this->assign('site_name', config('app.site_name'));
}
应改造为：
- 新建中间件
app/middleware/InitSiteData.php，在handle()中执行赋值逻辑（注意：不能直接调用$this->assign()，需通过ViewFacade 或注入Think\View实例） - 权限校验类逻辑（如
checkLogin()）应单独拆为AuthMiddleware，并在路由分组中绑定 - 若需对特定控制器生效，用闭包中间件 +
Request::controller()和Request::action()判断，避免全站拦截
中间件注册方式与作用域差异
注册位置决定执行范围，选错会导致逻辑漏触发或过度执行：
- 全局中间件（
app/middleware.php）：适用于所有请求，如日志、跨域头设置 - 路由中间件（
route/app.php中->middleware()）：精准控制某组路由，推荐用于权限或初始化数据 - 控制器中间件（
__construct()中调用middleware()）：TP6.1+ 支持，但仅限当前控制器，注意该写法不支持带参数的中间件
特别注意：app/middleware.php 中的中间件默认不接收参数；若需传参（如指定模块白名单），必须改用闭包中间件或自定义中间件类的构造注入方式。
容易踩的坑：模板变量、请求参数、异常处理
中间件中无法直接使用 $this->assign() 或 $this->request，因为中间件不继承控制器基类：
- 模板变量需通过
think\facade\View::assign()设置，且确保视图引擎已初始化（建议放在Response发送前，即next($request)之后） - 获取请求参数请用
$request->param()或$request->get()，而非$this->request->param() - 中间件中抛出异常不会触发控制器的
error()方法，需手动捕获并调用think\exception\HttpException或返回json响应 - TP6.3+ 若启用
swoole模式，中间件状态不共享，避免在中间件中写入静态变量或全局数组
复杂初始化逻辑（比如依赖多个服务、需异步加载配置）建议拆成多个轻量中间件，按需组合，而不是堆在一个中间件里做“全能初始化”。
