小工具拖到侧边栏后页面报错，旧版小工具还能用吗

问题现象

把归档小工具拖进侧边栏，前台直接出现致命错误提示。

原因分析

主题仍使用旧版小工具注册方式，与区块化小工具混用后参数结构不同。判断时先分清是 WordPress 小工具报错 本身的配置问题，还是上游调用、运行环境带进来的差异；前者改配置就能收口，后者要沿着请求链路一层层往上找，处理顺序不能颠倒。先在出问题的机器上复现一次，把报错原文和发生时间记下来，再对着日志定位。

处理步骤

1. 改用区块小工具或在 functions.php 恢复经典小工具
2. 检查小工具的回调函数参数
3. 关闭报错插件复测

对应的命令或配置片段如下，可直接复制：

add_filter('gutenberg_use_widgets_block_editor', '__return_false');
add_filter('use_widgets_block_editor', '__return_false');

排查时把每一步的输出留下来，后面再遇到同类问题，对照日志就能判断是哪一层先出错的。改动前把原配置备份一份，出问题时能马上回退，比现场找原因省时间。

验证结果

小工具正常显示在侧边栏，页面无报错。