app_init是TP5.1/5.2应用初始化后首个钩子，容器已就绪但Request未创建，仅可安全调用app()获取服务、路径常量等；不可用request()/input()/Db::table()；常见失效原因包括tags.php缺失或格式错误、命名空间不匹配、run()方法含参数、重复注册；TP6中已被AppInit事件替代。
ThinkPHP 5.1/5.2 中，app_init 是应用初始化完成后的第一个钩子点，行为类在此处执行时，容器已初始化但请求对象尚未创建 —— 所以别在 run() 里直接调 request() 或 input()，会报错或返回 null。
app_init 行为类里能用什么？
这个钩子发生在 App::init() 之后、App::run() 之前，此时：
- 容器已可用，可安全调用
app('config')、app('cache')等服务 - 路由未加载，
Request实例还未生成，thinkRequest::instance()返回null - 模块路径已确定，可读取
app_path()、runtime_path()等常量 - 数据库连接未建立，
Db::table()类操作会触发延迟初始化失败（除非你手动预热）
为什么 app_init 行为没执行？
常见静默失效原因：
-
app/tags.php文件不存在，或返回值不是数组（比如忘了return [...]） - 行为类命名空间写错，如写成
appehaviorCheckAuth但实际类文件在application/behavior/CheckAuth.php且声明为appehaviorCheckAuth—— 注意 ThinkPHP 5 默认应用目录是application，不是app - 行为类的
run()方法有构造参数依赖，例如__construct(Config $config)，框架反射实例化时会直接跳过该行为（不报错，也不执行） - 钩子被重复注册：同一行为类出现在多个
tags.php（如模块级和应用级），而框架只取最后一个
如何调试 app_init 是否生效？
不要靠日志“猜”，直接查注册状态：
立即学习“PHP免费学习笔记（深入）”；
- 在控制器中加一行：
dump( hink acadeHook::getListeners('app_init'));，看返回数组是否含你的行为类名 - 如果返回空数组，说明
tags.php没被加载，检查路径是否为application/tags.php（TP5.1+ 不再支持app/tags.php） - 如果返回了类名但行为仍不执行，用
dd(class_exists('app\behavior\CheckAuth'))确认类能否自动加载 - 别在
run()里写echo或var_dump—— CLI 环境下可能看不到输出，改用trace()或写入runtime/log/
TP6 用户注意：app_init 已不是钩子，而是事件
ThinkPHP 6 完全移除了 Hook，app_init 对应的是 thinkEventAppInit 事件：
- 监听方式变为
Event::listen('AppInit', [AppListener::class, 'onAppInit']) - 事件参数是
thinkEvent实例，可通过$event->app获取应用对象 - 旧版
app_init行为类不能直接复用，必须重写为监听器，且不再强制要求方法名为run - 强行在 TP6 中 require TP5 的
Hook类，会导致行为静默不执行 —— 因为没有容器绑定，也没有事件调度器接管
最易忽略的一点：TP5 中 app_init 行为类的 run() 方法签名是 public function run()，无参；哪怕你加个空参数 public function run($params = [])，框架也会因反射匹配失败而跳过它 —— 这个细节在文档里几乎不提，但实际踩坑率极高。
