跳到主要内容
万能墙开放平台
插件开发教程

性能与预算(慢钩子会被熔断)

全部内容基于万能墙真实的插件平台(清单 + 钩子 + 接口 + 后台页 + 数据 + 定时任务),示例可直接复制运行。

钩子跑在请求主链路里

addAction() / addFilter() 注册的回调,会在用户那次请求里同步执行:前台打开一个页面、客户端调一次接口,平台都会按优先级依次调用相关钩子。回调花掉的时间,会直接叠加到用户的等待时间里。

所以:能异步做的(发信、同步到外部系统)尽量交给定时任务;能缓存的不要每次请求都算;绝不要在渲染钩子里查数据库或请求外网。

预算与熔断

平台会给每个回调计时,并对异常做隔离:

  • 单个回调耗时超过 PLUGIN_SLOW_HOOK_MS(默认 300 ms):记为一次「慢钩子」,写入插件日志;
  • 单个回调耗时超过 PLUGIN_HOOK_HARD_MS(默认 2000 ms):按故障处理,计入熔断统计;
  • 回调抛异常:同样被平台捕获、记故障,不会把整站打挂;
  • 同类故障在统计窗口内频繁出现:插件会被自动熔断停用,站长后台可重置熔断后重试。

> 上面的数值以核心常量为准(本页取不到核心时展示的是默认值);阈值由站长/核心版本决定,插件无法改。

哪些钩子最容易拖慢站点

渲染注入区(每个页面都会跑,最危险):

  • plugin_render_body_top
  • plugin_render_footer
  • plugin_render_head
  • plugin_render_nav_extra
  • plugin_render_profile_cards
  • plugin_render_settings_cards

还包括所有标注「任意请求都会触发」的动作/过滤器(发布、评论、响应改写等,见「扩展点全表」的触发时机说明)。这些钩子里的每一毫秒都会被所有访客一起承担。

优化建议(照做基本不会触发熔断)

1. 渲染钩子里只拼字符串:需要的数据提前算好、缓存好,不在钩子里 SELECT、file_get_contents、pluginHttp()。

2. 用定时任务做重活:registerPluginCron() 适合清理、同步、汇总;间隔最小 60 秒,由站点流量驱动。

3. 缓存热点数据:把统计结果写进插件自己的表或设置项,按需刷新,而不是每次请求重算。

4. 给外部请求设超时与上限:pluginHttp() 已带超时与体积上限;自己写 curl 时务必设置 CURLOPT_TIMEOUT。

5. 限制数据量:列表/统计加上 LIMIT,别在钩子里做全表扫描或大数组排序。

6. 前缀钩子从简:api_request 这类进入即触发的钩子里只做轻量判断,不要做重活。

7. 本地先量一下:在测试站用浏览器开发者工具看页面耗时,或临时打点,确认插件带来的开销在可接受范围。