WordPress插件激活仅成功创建一张表，求排查第二张表创建失败原因

核心问题分析 #

你的代码中第二张表创建失败，主要是两个原因：

• 存储引擎不支持外键：WordPress默认表引擎可能是MyISAM，它不支持外键约束，而你的关联表依赖外键关联，导致创建失败。
• dbDelta语法不符合规范：WordPress的dbDelta()函数对SQL语法有严格要求，你的写法不符合它的解析规则。

修复后的代码 #

register_activation_hook( __FILE__, 'create_tables_in_db' );
function create_tables_in_db() {

    global $wpdb;
    $charset_collate = $wpdb->get_charset_collate();
    $table_dm = $wpdb->prefix . 'dmtl_danhmuc';
    $table_dm_term_rel = $wpdb->prefix . 'dm_term_relations';
    $table_term_taxonomy = $wpdb->prefix . 'term_taxonomy';
    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );

    // 创建分类表
    $sql = "CREATE TABLE $table_dm (
        id bigint(20) NOT NULL AUTO_INCREMENT,
        name CHAR(100) NOT NULL,
        active tinyint(1) DEFAULT 1 NOT NULL,
        items_quantity tinyint(3) DEFAULT 0,
        PRIMARY KEY  (id)
    ) $charset_collate ENGINE=InnoDB;";
    dbDelta( $sql );

    // 创建关联表
    $sql_rel = "CREATE TABLE $table_dm_term_rel (
        id bigint(20) NOT NULL AUTO_INCREMENT,
        term_taxonomy_id bigint(20) NOT NULL,
        dm_id bigint(20) NOT NULL,
        PRIMARY KEY  (id),
        KEY term_taxonomy_id (term_taxonomy_id),
        KEY dm_id (dm_id),
        FOREIGN KEY (term_taxonomy_id) REFERENCES $table_term_taxonomy(term_taxonomy_id) ON DELETE CASCADE,
        FOREIGN KEY (dm_id) REFERENCES $table_dm(id) ON DELETE CASCADE
    ) $charset_collate ENGINE=InnoDB;";
    dbDelta( $sql_rel );
}

关键修改说明 #

1. 强制使用InnoDB引擎：在两张表的SQL末尾添加ENGINE=InnoDB，确保支持外键约束。
2. 规范dbDelta语法：
   • 主键字段添加NOT NULL AUTO_INCREMENT，并单独声明PRIMARY KEY (id)，符合dbDelta的解析要求。
   • 把BOOLEAN替换为tinyint(1)（MySQL中BOOLEAN本质是TINYINT(1)，兼容性更好）。
   • 给外键关联字段添加普通索引（KEY term_taxonomy_id (term_taxonomy_id)），外键依赖索引才能生效。
   • 给外键字段添加NOT NULL约束，避免空值导致关联失败。
3. 添加外键级联操作：ON DELETE CASCADE确保关联数据被删除时，关联表的对应记录也会被清除，避免数据残留。

额外排查步骤 #

• 查看MySQL错误日志，确认具体报错信息（可通过phpMyAdmin或主机控制面板查看）。
• 激活插件后，检查wp_options表中的{$wpdb->prefix}_db_version字段，确认dbDelta是否识别了表结构变化。
• 手动在数据库中执行第二张表的SQL语句，验证是否是语法或引擎问题。

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