使用WordPress $wpdb类通过Ajax插入数据库失败求助

问题定位 #

你的代码存在以下几个关键错误：

1. 数据库表名拼接错误：使用了反引号 `activity_notes` 拼接表名，PHP中反引号用于执行系统命令，应该用单引号包裹表名。
2. AJAX参数位置错误：把type和dataType放在了data对象内部，这两个是$.ajax的顶层配置参数，不属于提交的数据。
3. 请求判断逻辑无效：isset($_REQUEST)永远返回true，无法有效校验必填参数notes_editor1是否存在。
4. 未正确终止AJAX请求：WordPress AJAX处理函数末尾需要调用终止方法，否则会额外返回0，干扰处理流程。
5. 前台用户权限缺失：若需要允许未登录用户提交，需解开wp_ajax_nopriv_notes的注释。

修复后的代码 #

前端JS代码

<script>
$("#notes_maker").submit(function(event){
    event.preventDefault();
    var formURL = "<?php echo admin_url('admin-ajax.php')?>";
    var notes_editor = $("#notes_area").val();

    $.ajax({
        url: formURL,
        type: 'POST', // 移到顶层参数
        dataType: 'text', // 移到顶层参数
        data: {
            'action': 'notes',
            'notes_editor1': notes_editor
        },
        success: function(data) {
            alert("提交成功，返回内容：" + data);
        },
        error: function(xhr) {
            alert("提交失败，错误码：" + xhr.status);
        }
    });
});
</script>

后端functions.php代码

function my_ajax_notes() {
    // 校验必填参数是否存在且不为空
    if(isset($_POST['notes_editor1']) && !empty($_POST['notes_editor1'])) {
        $car = sanitize_textarea_field($_POST['notes_editor1']); // 安全过滤用户输入

        global $wpdb;
        $table_name = $wpdb->prefix . 'activity_notes'; // 修正表名拼接方式

        // 执行插入操作并判断结果
        $insert_result = $wpdb->insert(
            $table_name,
            ['text' => $car],
            ['%s'] // 明确字段类型，增强安全性
        );

        if($insert_result) {
            echo "插入成功，ID：" . $wpdb->insert_id;
        } else {
            echo "插入失败，错误信息：" . $wpdb->last_error;
        }
    } else {
        echo "参数缺失或为空";
    }
    
    wp_die(); // 必须终止AJAX请求
}

add_action('wp_ajax_notes', 'my_ajax_notes');
add_action('wp_ajax_nopriv_notes', 'my_ajax_notes'); // 允许未登录用户调用（按需开启）

额外建议 #

1. 安全过滤：始终使用WordPress提供的过滤函数处理用户输入，防止SQL注入和XSS攻击。
2. 错误调试：通过$wpdb->last_error可以查看具体的数据库错误信息，快速定位问题。
3. 结构化返回：推荐使用wp_send_json_success()和wp_send_json_error()返回JSON格式数据，更便于前端处理状态和信息。

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