WordPress跨类调用add_action注册钩子方法不生效问题求助

问题原因 #

• 核心原因是钩子注册时机晚于admin_notices钩子的执行时机：WordPress后台的admin_notices钩子是在后台页面初始化阶段、页面内容输出前统一触发的。第一种写法是脚本加载时直接执行(new Show())->error()注册钩子，只要脚本加载时机在admin_notices触发前就能正常生效。
• 第二种写法中，Manager->add()方法的调用时机晚于admin_notices的执行时间点，此时钩子已经跑完了，后续再注册回调自然不会被触发。常见的场景包括add()方法是在表单提交回调、页面模板渲染逻辑、晚于admin_notices的其他钩子中被调用。

解决方法 #

方案1：调整注册逻辑的执行时机 #

把注册admin_notices的逻辑提前到脚本初始化阶段，不要放在业务触发的方法里：

// 直接在全局初始化阶段注册，只要执行时机在 admin_notices 之前即可
add_action('init', function() {
    $manager = new Manager();
    // 满足触发通知的业务条件时，在init阶段调用注册，不要等到后续逻辑
    if (/* 你的业务判断条件 */) {
        $manager->add();
    }
});

方案2：改用暂存机制实现跨请求通知 #

如果你的add()方法本身就是在admin_notices执行之后才会触发（比如表单提交后的处理逻辑），可以用WordPress的transient或者用户元数据暂存通知标记，下一次页面加载时再输出：

class Show
{
    public function error()
    {
        // 给当前用户存一个通知标记，有效期1分钟
        set_transient('show_admin_notice_' . get_current_user_id(), true, 60);
        // 同时注册钩子，当前请求如果没跑完admin_notices就直接输出，跑完了就等下一次请求
        add_action('admin_notices', [$this, 'pip1']);
    }

    public function pip1() {
        $user_id = get_current_user_id();
        // 判断是否有通知标记
        if (get_transient('show_admin_notice_' . $user_id)) {
            echo '<div class="notice notice-success"><p>test</p></div>';
            // 用完就删除标记，避免重复展示
            delete_transient('show_admin_notice_' . $user_id);
        }
    }
}

// 全局提前注册这个通知钩子，不管什么时候需要展示都能生效
add_action('admin_init', function() {
    (new Show())->error();
});

内容的提问来源于stack exchange，提问作者Mohammad