常用生命周期挂载点与调试：一次插件加载顺序引发的白屏排查

上周帮朋友看一个插件问题，现象很典型：后台开启插件后前台直接白屏，关掉就正常。日志里只有一句“Call to undefined function”，但函数明明在插件文件里定义了。

问题最后定位到生命周期挂载顺序上。这里把排查过程和我平时调试常用生命周期的方法整理一下，适合刚接触插件开发、对 hook 挂载时机还不太熟的朋友。

一、先搞清楚你的代码挂在哪个阶段

很多人写插件时习惯把逻辑全塞进一个文件，然后在文件顶部直接执行。这样做的隐患是：你无法控制它相对于核心代码的执行顺序。常见生命周期大致分三类：

1. 初始化阶段：核心还没加载完，此时只能做常量定义、类声明，不要查数据库、不要调其他插件函数。

2. 请求处理阶段：路由已解析、用户已鉴权，适合做权限判断、参数过滤。

3. 输出/渲染阶段：模板已就绪，适合改视图、注入变量。

把“查数据库”放在初始化阶段，或者把“改模板”放在请求处理之前，都是白屏和报错的常见来源。

二、我常用的三个调试动作

动作一：在疑似挂载点前后各打一条日志，只写阶段名，不写变量。先确认代码到底有没有被执行，再谈执行对不对。

动作二：用最小化插件测试。把插件逻辑清空，只保留挂载声明，逐个恢复功能块，看在哪一步白屏。比读代码快得多。

动作三：临时把错误显示打开，但只在自己本地环境开。线上开 display_errors 容易泄露路径，排查完立刻关掉。

三、这次白屏的具体原因

插件在初始化阶段就调用了另一个插件的函数，而那个插件还没加载。两个插件单独开都正常，同时开就崩。解决办法是把调用延后到请求处理阶段，或者用 hook 的优先级参数控制先后。

顺带提醒：hook 注册时如果支持优先级，数字越小越先执行。不确定默认值就显式写清楚，别依赖“应该会按注册顺序来”。

四、一个可以复用的检查顺序

白屏 → 看错误日志有没有 fatal → 有就顺着文件行号看挂载阶段 → 没有就开最小化插件二分排查 → 确认阶段后检查依赖的其他插件或核心函数是否已就绪 → 最后才去改代码逻辑。

按这个顺序走，大部分生命周期相关的白屏都能在十分钟内定位。如果你也遇到过类似“单独开没事、一起开就崩”的情况，欢迎回帖说说你的挂载点是怎么调的。