使用wpdb->insert插入Gravity Forms字段到WP数据库失败排查

• 修复变量大小写问题：PHP变量名区分大小写，你定义的是$tablename，但插入操作中用的是$tableName，这会导致表名未定义，直接统一变量名即可，比如都用$tablename。
• 移除自增字段的手动赋值：如果event_id是表的自增主键，不需要手动传入NULL，$wpdb->insert()会自动处理自增字段，保留这个赋值反而可能触发数据库约束错误，直接删除'event_id'=> NULL这一项。
• 使用动态表前缀：不要硬编码wp_前缀，改用$wpdb->prefix拼接表名，比如$tablename = $wpdb->prefix . 'past_speaking_events';，避免站点自定义前缀导致找不到表。
• 添加错误调试代码：在$wpdb->insert()后加入错误检测，定位具体问题：

  if ($wpdb->last_error) {
      error_log('数据库插入错误: ' . $wpdb->last_error);
      // 测试阶段可临时用echo输出错误，上线后删除
      // echo '错误信息: ' . $wpdb->last_error;
  }
  

  同时在wp-config.php开启调试日志：

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

  查看wp-content/debug.log获取详细错误信息。
• 验证数据类型匹配：确认数据库表中post_id、author是整数类型，event_title、event_description是字符串类型，避免类型不匹配导致插入失败。
• 检查数据库权限：确保WordPress使用的数据库用户拥有目标表的INSERT权限，无权限会导致静默插入失败。

修改后的示例代码 #

// create a past speaking event
add_action( 'gform_after_submission_8', 'add_past_speaking_event', 10, 2 );
function add_past_speaking_event($entry, $form) {
    global $wpdb;

    $author = $entry[1];
    $postID = $entry[9];
    $eventTitle = $entry[6];
    $event_description = $entry[8];

    $tablename = $wpdb->prefix . 'past_speaking_events';

    $wpdb->insert(
        $tablename,
        array(
            'post_id' => $postID,
            'author' => $author,
            'event_title' => $eventTitle,
            'event_description' => $event_description
        ),
        array('%d', '%d', '%s', '%s')
    );

    // 调试用代码，测试完成后可删除
    if ($wpdb->last_error) {
        error_log('Past Speaking Event Insert Error: ' . $wpdb->last_error);
    }
}

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