问题背景
在 WordPress 开发中，init 钩子是一个核心的动作钩子，用于在 WordPress 环境初始化完成后执行代码。然而，如果插件或主题中的回调函数被错误地多次挂载到 init 钩子上，或者函数本身被多次调用，可能会导致严重的性能问题，例如数据库查询重复执行、资源重复加载，甚至引发逻辑错误。
解决方案：使用静态变量或标志位
最直接有效的方法是在回调函数内部使用一个静态变量（static variable）或类属性来记录函数是否已经执行过，从而避免重复执行。
方法一：在普通函数中使用静态变量
function my_custom_init_action() {
static $has_run = false;
if ( $has_run ) {
return;
}
$has_run = true;
// 你的实际初始化代码放在这里
// 例如：注册自定义文章类型、添加短代码等
// 这段代码只会执行一次
register_post_type( 'my_product', array(
'public' => true,
'label' => '产品'
) );
}
add_action( 'init', 'my_custom_init_action' );原理说明：静态变量 $has_run 在函数首次调用时被初始化为 false，并在执行核心代码后设置为 true。当 WordPress 的 init 钩子意外地多次触发此函数时，后续的调用会因条件判断而直接返回，从而保护了核心逻辑。
方法二：在类方法中使用属性
如果你的代码是以面向对象（OOP）方式组织的，可以使用类的私有属性来达到相同目的。
class MyPluginInit {
private $has_run = false;
public function setup() {
add_action( 'init', array( $this, 'init_action' ) );
}
public function init_action() {
if ( $this->has_run ) {
return;
}
$this->has_run = true;
// 你的实际初始化代码
// 这段代码只会执行一次
flush_rewrite_rules(); // 示例：刷新重写规则
}
}
$my_plugin = new MyPluginInit();
$my_plugin->setup();检查钩子挂载次数
有时问题并非源于函数内部，而是因为 add_action 语句被多次执行，导致同一个回调函数被多次挂载到钩子上。你可以通过以下方式调试：
// 检查 `init` 钩子上某个回调函数的挂载次数
$hook_count = has_action( 'init', 'my_custom_init_action' );
if ( $hook_count ) {
error_log( 'my_custom_init_action 被挂载到 init 钩子的次数：' . $hook_count );
}如果输出次数大于 1，说明你的 add_action 调用可能位于一个会被多次加载的文件中（例如在模板的循环内），或者插件被重复初始化。你需要确保初始化代码（如 add_action）只在主插件文件或主题的 functions.php 中执行一次。
高级模式：使用 WordPress 的 `did_action` 函数
WordPress 提供了一个函数 did_action( $hook_name )，它返回指定钩子已经被触发的次数。虽然 init 钩子在一次请求中通常只触发一次，但在某些特殊情况下（如 AJAX、REST API 请求）可能被多次触发。你可以利用它进行更精细的控制。
function my_conditional_init_action() {
// 确保只在主请求的 init 中执行，避免在 AJAX 等场景重复执行
if ( did_action( 'init' ) > 1 ) {
return;
}
// 你的初始化代码
// ...
}
add_action( 'init', 'my_conditional_init_action' );注意：此方法适用于需要严格区分“首次主请求初始化”和“后续子请求”的场景，对于防止同一页面请求内的重复执行，首选仍是静态变量法。
最佳实践与总结
- 单一职责：确保挂载到
init钩子的函数只负责初始化工作，逻辑应简洁。 - 防御性编程：始终在关键的一次性操作函数中加入“只执行一次”的保护逻辑。
- 代码位置：将
add_action( 'init', ... )调用放在插件主文件或主题functions.php的根作用域，确保不会因条件判断或循环而重复执行。 - 性能监控：使用 Query Monitor 等调试插件，检查
init钩子上的回调函数数量和执行时间。
通过实施上述策略，你可以有效避免因 init 钩子回调函数多次执行而导致的性能损失和潜在错误，使你的 WordPress 插件或主题运行更加高效稳定。