WordPress表插入行失败排查：TablePress数据写入问题求助

核心问题根源 #

你当前代码无法写入TablePress表的核心原因是对TablePress的存储结构理解错误：

• TablePress的数据库表并非用A/B/C这类列名作为数据库字段，而是将所有表格数据序列化后存在data字段中，直接用$wpdb->insert操作列名会因字段不存在而失败。
• 代码缺失数据库操作错误日志，无法定位具体失败原因。
• 未实现批量邮件队列逻辑，仍在实时发送邮件，未达到SiteGround限频下的批量发送需求。

修复与优化方案 #

一、修正TablePress数据写入逻辑（或改用自定义队列表） #

TablePress本质是前端展示工具，不适合作为邮件队列的存储载体，更推荐创建自定义临时表；如果一定要用TablePress，需使用其官方API：

选项1：使用TablePress官方API写入数据

// 确保TablePress已加载
if ( class_exists( 'TablePress' ) ) {
    $table_id = 1;
    // 加载目标表
    $table = TablePress::$model_table->load( $table_id );
    // 新增行（数组顺序对应TablePress的A/B/C/D/E列）
    $new_row = array(
        $email_subject,
        $email_body,
        $recipient_email,
        $post_title,
        $post_url
    );
    $table['data'][] = $new_row;
    // 保存修改
    TablePress::$model_table->save( $table );
}

选项2：创建自定义邮件队列表（更适合批量场景）

在Astra子主题的functions.php中添加表创建逻辑：

// 主题激活时创建邮件队列表
add_action( 'after_switch_theme', 'create_email_queue_table' );
function create_email_queue_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'email_notification_queue';
    
    $charset_collate = $wpdb->get_charset_collate();
    
    $sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        recipient_email varchar(100) NOT NULL,
        email_subject text NOT NULL,
        email_body text NOT NULL,
        post_title text NOT NULL,
        post_url text NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        sent tinyint(1) DEFAULT 0 NOT NULL,
        PRIMARY KEY  (id)
    ) $charset_collate;";
    
    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}

然后替换原代码中的写入逻辑：

// 插入到自定义队列表
$insert_result = $wpdb->insert(
    $wpdb->prefix . 'email_notification_queue',
    array(
        'recipient_email' => $recipient_email,
        'email_subject' => $email_subject,
        'email_body' => $email_body,
        'post_title' => $post_title,
        'post_url' => $post_url
    ),
    array( '%s', '%s', '%s', '%s', '%s' ) // 指定数据类型，提升安全性
);

// 记录错误日志用于调试
if ( !$insert_result ) {
    error_log( '邮件队列插入失败: ' . $wpdb->last_error );
    error_log( '使用的表名: ' . $wpdb->prefix . 'email_notification_queue' );
}

二、实现批量发送与邮件合并逻辑 #

针对SiteGround每小时400封邮件的限制，添加定时任务批量发送，并合并同一用户的多篇匹配文章：

// 注册定时任务
add_action( 'wp', 'setup_batch_email_cron' );
function setup_batch_email_cron() {
    if ( ! wp_next_scheduled( 'send_batch_email_notifications' ) ) {
        // 每小时执行一次批量发送
        wp_schedule_event( time(), 'hourly', 'send_batch_email_notifications' );
    }
}

// 批量发送核心函数
add_action( 'send_batch_email_notifications', 'send_batch_emails' );
function send_batch_emails() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'email_notification_queue';
    $max_per_hour = 400; // SiteGround限制
    $sent_count = 0;

    // 按用户邮箱分组，获取未发送的邮件数据
    $user_groups = $wpdb->get_results( "
        SELECT recipient_email, 
               GROUP_CONCAT(post_title SEPARATOR '\n- ') AS merged_titles,
               GROUP_CONCAT(post_url SEPARATOR '\n- ') AS merged_urls
        FROM $table_name 
        WHERE sent = 0 
        GROUP BY recipient_email
    ", ARRAY_A );

    foreach ( $user_groups as $group ) {
        if ( $sent_count >= $max_per_hour ) break;

        // 合并邮件内容
        $merged_subject = '新职位空缺匹配你的关键词';
        $merged_body = '以下职位空缺符合你预设的关键词：' . "\n\n"
            . '职位列表：' . "\n- " . $group['merged_titles'] . "\n\n"
            . '查看链接：' . "\n- " . $group['merged_urls'] . "\n\n"
            . '祝你求职顺利！' . "\n\n"
            . 'Bahrain JOBS' . "\n\n"
            . '备注：你可通过网站个人资料修改关键词偏好。';

        // 发送邮件并标记已发送
        if ( wp_mail( $group['recipient_email'], $merged_subject, $merged_body ) ) {
            $wpdb->update(
                $table_name,
                array( 'sent' => 1 ),
                array( 'recipient_email' => $group['recipient_email'], 'sent' => 0 )
            );
            $sent_count++;
        } else {
            error_log( '邮件发送失败，收件人：' . $group['recipient_email'] );
        }
    }
}

三、原代码优化点 #

1. 过滤无效用户：获取用户时只拉取设置了关键词的用户，减少循环次数：

   $users = get_users( array(
       'meta_key' => 'keyword_1',
       'meta_value' => '',
       'meta_compare' => '!='
   ) );
   

2. 修正关键词非空判断：原代码中!empty($user->keyword_1)错误，应改为!empty($user_keywords_string)。
3. 正则匹配优化：添加不区分大小写的匹配规则：$regex_pattern = '/\b' . preg_quote($keyword, '/') . '\b/ui';

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