WordPress插件激活时MySQL表创建失败排查求助

代码中的核心错误 #

你的代码里有两个关键语法错误，直接导致表无法创建：

1. SQL标识符用错了引号 #

MySQL里，表名、字段名这类标识符需要用**反引号（`）**包裹，而不是单引号（'）。单引号会被MySQL当成字符串，根本识别不出这是表名或字段。

2. PRIMARY KEY语法错误 #

定义主键时，主键名称不需要加引号，正确写法是PRIMARY KEY (id)；如果要给主键自定义名称，格式是PRIMARY KEY customer_id (id)（同样不需要引号）。

修正后的完整代码 #

<?php
/*
Plugin Name: Tait Fitness Tracker Plugin
Author: Mark
Version: 0.0.1
Description: This is a custom Plugin for TF
*/

if ( !defined( 'ABSPATH' ) ) exit;

// 插件激活钩子
register_activation_hook( __FILE__, "tf_activate_plugin" );

// 插件停用钩子
register_deactivation_hook( __FILE__, "tf_deactivate_plugin" );

// 激活逻辑
function tf_activate_plugin() {
    // 调试临时开启错误显示（上线后移除）
    error_reporting(E_ALL);
    ini_set('display_errors', 1);

    init_db_tfplugin();
}

// 停用逻辑
function tf_deactivate_plugin() {
    // 可添加插件停用后的清理操作
}

// 初始化数据库表
function init_db_tfplugin() {
    global $table_prefix, $wpdb;

    $tfcustomerTable = $table_prefix . 'tf_customer';

    // 安全检查：用prepare避免SQL注入风险
    if( $wpdb->get_var( $wpdb->prepare("SHOW TABLES LIKE %s", $tfcustomerTable) ) != $tfcustomerTable ) {
        $sql = "CREATE TABLE `$tfcustomerTable` (
            `id` int(11) NOT NULL auto_increment,
            `email` varchar(500) NOT NULL,
            `fname` varchar(500) NOT NULL,
            `sname` varchar(500),
            `line1` varchar(500) NOT NULL,
            `line2` varchar(500),
            `line3` varchar(500),
            `city` varchar(150) NOT NULL,
            `state` varchar(150),
            `area` varchar(15),
            `country` varchar(5) NOT NULL,
            PRIMARY KEY (`id`)
        ) ENGINE=MyISAM DEFAULT CHARSET=latin1 AUTO_INCREMENT=1;";

        require_once( ABSPATH . '/wp-admin/includes/upgrade.php' );
        dbDelta( $sql );

        // 调试：记录数据库错误（上线后移除）
        if ($wpdb->last_error) {
            error_log('数据库创建错误: ' . $wpdb->last_error);
        }
    }
}

错误追踪方法（针对.NET背景开发者） #

1. 开启WordPress调试模式 #

修改网站根目录的wp-config.php，找到以下配置并修改：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

• WP_DEBUG：全局开启调试模式
• WP_DEBUG_LOG：把错误写入wp-content/debug.log文件，方便查看
• WP_DEBUG_DISPLAY：不在前端显示错误，避免影响普通用户

2. 查看PHP错误日志 #

• 本地环境（XAMPP/WAMP）：Apache错误日志一般在xampp/apache/logs/error.log；Nginx则在对应版本的日志目录
• 虚拟主机：直接在主机控制面板（如cPanel）的"错误日志"入口查看

3. 直接捕获数据库错误 #

在调用dbDelta之后，用$wpdb->last_error获取最后一次数据库操作的错误信息，像上面代码里那样写入日志，或者临时echo输出，快速定位问题。

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