常用生命周期钩子挂载与调试：从一次“登录后积分没到账”说起

上周帮朋友看一个插件问题：用户登录后应该加积分，但死活不加。查了半天，问题出在钩子挂错了生命周期——他把逻辑挂在了 login_start，而那时候用户还没验证通过，拿不到 uid。这事让我觉得有必要把常用生命周期怎么挂、怎么调试单独捋一遍。

先说结论：挂钩子之前，先问自己三个问题——这个时机点数据齐了吗？我要改的东西这时候存在吗？如果出错，日志会打在哪？想清楚这三个，能省掉八成调试时间。

一、几个最容易挂错的生命周期

用户登录相关：登录流程通常分“开始验证”和“验证成功”两个阶段。如果你想在登录后写积分、写日志、发通知，必须挂在验证成功之后那个钩子，而不是开始验证时。开始验证时用户身份还没确认，uid 是空的或者不可信。判断方法很简单：在钩子里打印一下当前用户对象，如果 uid 为 0 或 null，说明挂早了。

帖子发布相关：发帖也有“提交前”和“提交后”两个阶段。想在帖子里追加字段、改内容，挂提交前；想发通知、加积分、写统计，挂提交后。挂错的典型症状是：数据写进去了但帖子表里没有，或者帖子有了但通知发不出去。

插件加载相关：插件自身的初始化钩子只在插件被加载时触发一次，不是每次请求都触发。如果你把每次请求都要执行的逻辑挂在这里，会发现只有第一次生效。这种逻辑应该挂在路由分发或控制器初始化阶段。

二、怎么确认钩子真的触发了

最土但最有效的办法：在钩子函数第一行写 error_log('hook_name triggered');，然后看 PHP 错误日志。别用 echo 或 var_dump，页面输出会干扰你判断，而且有些钩子在输出缓冲区里，你根本看不到。

如果日志里没有这行，说明钩子没触发。原因通常是三种：钩子名拼错了、挂载时机太晚（插件加载时钩子已经执行过了）、或者这个钩子在当前请求路径下压根不会走到。第三种最容易被忽略——比如你挂的是后台钩子，但你在前台页面测试，当然不触发。

如果日志里有这行但逻辑没生效，那问题就在钩子内部。这时候在关键变量处再打几条日志，看数据是不是你预期的样子。常见坑是：钩子参数是个引用，你以为改的是原对象，其实改的是副本；或者钩子返回值的处理方式和你以为的不一样，有的钩子需要 return 新值，有的直接改引用就行。

三、调试顺序建议

遇到钩子问题，按这个顺序排查：先确认钩子名和挂载位置对不对，再确认钩子有没有触发，然后确认钩子内部数据对不对，最后确认你的修改有没有被后续流程覆盖。最后一步很多人会漏——你改了数据，但后面还有别的钩子或逻辑把它改回去了，表现出来就像你没改一样。

另外，不同版本或不同插件之间钩子执行顺序可能不一样。如果你依赖某个钩子在你之后执行，最好用优先级参数控制，别赌默认顺序。没有优先级参数的话，就在文档里写清楚你的插件需要什么顺序，让后来的人知道。

挂钩子这件事，说到底是“在对的时间做对的事”。时间点选错了，代码写得再漂亮也没用。下次挂之前，先花两分钟想清楚时机，比事后查半天日志划算得多。