WordPress自定义插件报Undefined array key错误该如何修复？

报错原因 #

这个警告触发的核心逻辑是：代码在页面没有收到POST表单提交时，就直接访问$_POST数组中不存在的键。而且你当前的代码逻辑顺序有误：先读取所有$_POST参数，之后才判断是否有提交动作（isset($_POST['save'])），页面首次加载没有POST数据时就会批量触发未定义数组键警告。
另外你的代码还存在一个隐性BUG：$wpdb->insert的格式数组只定义了5个%s，但实际要插入8个字段，格式数量和字段数量不匹配会导致数据插入异常。

排查步骤 #

• 核对后台表单的字段name属性，确保和代码中$_POST读取的键名完全一致，拼写、大小写均不能出错，比如不要出现home_team写成home-team的笔误
• 确认表单提交方式为method="post"，不要误写为get
• 确认DBP_insert_data函数的触发时机，仅在表单提交的钩子中挂载，不要页面加载就直接执行

修复代码 #

调整逻辑顺序，把参数读取逻辑移到提交判断内部，同时用null合并运算符??给每个参数设置默认值，避免字段未传递时报错，补全插入格式：

function DBP_insert_data()
{
    global $wpdb;
    $table_name = $wpdb->prefix . 'funstar_league';

    // 仅检测到提交动作时才处理数据
    if (isset($_POST['save'])) {
        // 用null合并运算符设置空字符串默认值，避免未定义键警告
        $DBP_home = $_POST['home_team'] ?? '';
        $DBP_guest = $_POST['guest_team'] ?? '';
        $DBP_home_team_url_logo = $_POST['home_team_url_logo'] ?? '';
        $DBP_guest_team_url_logo = $_POST['guest_team_url_logo'] ?? '';
        $DBP_url = $_POST['url'] ?? '';
        $DBP_place = $_POST['place'] ?? '';
        $DBP_time = $_POST['game_time'] ?? '';
        $DBP_date = $_POST['game_date'] ?? '';

        // 可选：增加必填字段校验，避免插入无效数据
        if (empty($DBP_home) || empty($DBP_guest)) {
            add_settings_error('dbp_notice', 'dbp_empty_field', '主队、客队名称为必填项', 'error');
            return;
        }

        $wpdb->insert(
            $table_name,
            array(
                'home_team' => $DBP_home,
                'guest_team' => $DBP_guest,
                'home_team_url_logo' => $DBP_home_team_url_logo,
                'guest_team_url_logo' => $DBP_guest_team_url_logo,
                'url' => $DBP_url,
                'place' => $DBP_place,
                'game_time' => $DBP_time,
                'game_date' => $DBP_date,
            ),
            // 补全8个字段对应的数据格式，和前面的字段一一对应
            array(
                '%s',
                '%s',
                '%s',
                '%s',
                '%s',
                '%s',
                '%s',
                '%s',
            )
        );
    }
}

内容的提问来源于stack exchange，提问作者Tomáš Valach