WordPress插件激活钩子调用数据库表创建函数失败的解决方法

一、问题根源分析 #

1. “额外字符传入头部”异常：
   该错误是因为schema.php存在意外输出——比如<?php标签前有空格、换行或BOM字符，或文件末尾?>标签后有多余空白。WordPress激活钩子执行时不允许任何输出，否则会触发HTTP头已发送的错误。

2. 钩子无反应、表未创建：
   改成array('schema', 'create_schema')后无效，是因为create_schema是全局函数，并非schema类的静态方法，这种回调格式仅适用于类方法，导致钩子未触发。

二、具体修复步骤 #

步骤1：清理schema.php的输出问题 #

打开schema.php，确保：

• 文件最开头就是<?php，无任何前置空格、换行或特殊字符；
• 删除文件末尾的?>标签（PHP会自动闭合，避免后续空白输出）；
• 函数内部不要有echo、print、var_dump等输出语句。

修正后的schema.php示例：

<?php
function create_schema(){
    global $wpdb, $table_prefix;
    $charset_collate = $wpdb->get_charset_collate();
    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );

    $market_information   = $table_prefix . 'market_information';

    // 用prepare避免SQL注入，同时检查表是否存在
    if($wpdb->get_var($wpdb->prepare("SHOW TABLES LIKE %s", $market_information)) != $market_information){
        // 符合dbDelta要求的SQL格式：每行一个字段，主键单独成行，结尾无分号
        $sql = "CREATE TABLE $market_information (
            id INT NOT NULL UNIQUE AUTO_INCREMENT,
            market_id INT,
            `key` VARCHAR(150),
            value VARCHAR(500),
            PRIMARY KEY (id)
        ) $charset_collate";
        dbDelta($sql);
    }
    // 其他表的创建逻辑...
}

步骤2：正确注册激活钩子 #

因为create_schema是全局函数，直接使用原始钩子注册方式即可，同时用绝对路径引入文件避免路径问题：

plugin.php代码：

// 用绝对路径引入schema.php，避免目录结构变化导致的文件找不到问题
require_once plugin_dir_path(__FILE__) . 'schema.php';

// 注册激活钩子，直接传入全局函数名
register_activation_hook(__FILE__, 'create_schema');

步骤3：排查执行问题（可选） #

如果表仍未创建，可在create_schema开头添加日志排查：

function create_schema(){
    // 写入错误日志，确认函数是否触发
    error_log("create_schema函数已执行");
    global $wpdb, $table_prefix;
    // 剩余代码...
}

开启WP_DEBUG后查看wp-content/debug.log：如果日志未出现，说明钩子未注册成功；如果日志出现但表未创建，检查SQL语句或表存在判断逻辑。

三、可选：类封装的规范写法 #

若想使用类管理，将create_schema改为静态方法：

schema.php修改为：

<?php
class Schema {
    public static function create_schema(){
        global $wpdb, $table_prefix;
        $charset_collate = $wpdb->get_charset_collate();
        require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );

        $market_information   = $table_prefix . 'market_information';

        if($wpdb->get_var($wpdb->prepare("SHOW TABLES LIKE %s", $market_information)) != $market_information){
            $sql = "CREATE TABLE $market_information (
                id INT NOT NULL UNIQUE AUTO_INCREMENT,
                market_id INT,
                `key` VARCHAR(150),
                value VARCHAR(500),
                PRIMARY KEY (id)
            ) $charset_collate";
            dbDelta($sql);
        }
    }
}

plugin.php注册钩子：

require_once plugin_dir_path(__FILE__) . 'schema.php';

register_activation_hook(__FILE__, array('Schema', 'create_schema'));

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