使用dbDelta创建WordPress表时生成两张表的问题排查

这种情况我之前遇到过类似案例，大概率是代码执行时机不对或者被重复执行，导致两次生成表时$wpdb->prefix的值不一致，下面具体说几种可能的场景：

1. 代码在WordPress核心初始化前就跑了一次 #

WordPress的$wpdb对象和它的prefix属性，是在核心加载过程中逐步初始化的。如果你的建表代码直接放在插件主文件最顶部（没绑定任何WP钩子），或者绑定了太早的钩子（比如在plugins_loaded之前），第一次执行时$wpdb->prefix可能还没被正确赋值，变成空字符串，这时候SQL里的表名就是name，自然生成了name表。

等WP核心加载完成后，这段代码又被执行了第二次（比如通过正常的钩子触发），此时$wpdb->prefix已经是正确的wp_，于是又生成了wp_name表。

怎么验证？ #

在你的建表代码前面加一行调试代码：

global $wpdb;
var_dump($wpdb->prefix);
die();

刷新页面或者激活插件，如果第一次输出是空字符串，第二次输出wp_，那就坐实了这个问题。

解决办法： #

把建表代码放到WP初始化完成后的钩子中执行，比如admin_init或者plugins_loaded，确保$wpdb已经完全就绪：

add_action('plugins_loaded', function() {
    global $wpdb;
    $tablename = $wpdb->prefix . 'name';
    $sql = "CREATE TABLE IF NOT EXISTS $tablename(
        time_id INT(11) NOT NULL AUTO_INCREMENT,
        job VARCHAR(120) NOT NULL,
        employee VARCHAR(100) NOT NULL,
        date_entry DATETIME NOT NULL,
        duration INT(11) NOT NULL,
        PRIMARY KEY(time_id)
    );";
    require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
    dbDelta($sql);
});

2. 建表代码被重复触发执行 #

如果你是在插件激活钩子(register_activation_hook)里写的建表逻辑，可能因为服务器响应慢、页面重复刷新或者插件激活流程异常，导致这段代码被执行了两次。第一次执行时$wpdb->prefix可能还没加载完全生成name，第二次正常加载生成wp_name；或者两次执行的上下文不同，prefix值不一致。

解决办法： #

给激活逻辑加个“已执行”标记，避免重复运行：

register_activation_hook(__FILE__, 'my_plugin_setup_table');
function my_plugin_setup_table() {
    global $wpdb;
    // 检查是否已经创建过表
    $table_created = get_option('my_plugin_table_created_flag');
    if ($table_created) return;

    $tablename = $wpdb->prefix . 'name';
    $sql = "CREATE TABLE IF NOT EXISTS $tablename(
        time_id INT(11) NOT NULL AUTO_INCREMENT,
        job VARCHAR(120) NOT NULL,
        employee VARCHAR(100) NOT NULL,
        date_entry DATETIME NOT NULL,
        duration INT(11) NOT NULL,
        PRIMARY KEY(time_id)
    );";
    require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
    dbDelta($sql);

    // 设置标记，下次激活不再执行
    update_option('my_plugin_table_created_flag', true);
}

3. 变量作用域或者赋值出错 #

如果你的建表代码在函数内部，但忘了声明global $wpdb;，那函数里的$wpdb就是个未初始化的局部变量，prefix属性为空，生成name表；而如果其他地方正确调用了全局$wpdb执行了同样的代码，就会生成wp_name表。另外也要检查代码中有没有其他地方修改了$tablename变量的值，导致表名被改成了name。

验证方法： #

在$tablename = $wpdb->prefix . 'name';后面加一行输出：

var_dump($tablename);

如果看到输出过name和wp_name两种结果，就说明变量赋值有问题。

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