WordPress插件Ajax调用报错 无法使用add_post_meta等内置函数

两种写法报错的核心原因完全一致：你直接请求插件目录下的独立PHP文件时，请求不会经过WordPress的核心加载流程，add_post_meta()这类WordPress内置函数根本没有被加载，调用时必然抛出「未定义函数」错误。这是WordPress Ajax开发最常见的入门错误。

WordPress官方提供了统一的Ajax处理入口admin-ajax.php，所有请求走这个入口时会自动完成核心环境、插件、主题的加载，所有内置函数、自定义函数都可以正常调用，不需要自己引入WP核心文件。

1. 后端注册Ajax处理回调 #

在插件主文件dropbox.php中添加以下代码，把你的数据处理逻辑挂载到WordPress的Ajax钩子上：

// 挂载登录用户的Ajax处理回调，wp_ajax_后面的字符串是自定义的动作名
add_action('wp_ajax_save_dropbox_data', 'dropbox_save_data_handler');
// 如果需要支持未登录游客提交，再加下面这行，不需要可以删除
add_action('wp_ajax_nopriv_save_dropbox_data', 'dropbox_save_data_handler');

function dropbox_save_data_handler() {
    // 安全校验（强烈建议开启，防止跨站伪造请求）
    // if (!isset($_POST['nonce']) || !wp_verify_nonce($_POST['nonce'], 'dropbox_ajax_verify')) {
    //     wp_send_json_error('非法请求', 403);
    // }

    // 获取前端传递的参数
    $raw_data = isset($_POST['req']) ? stripslashes($_POST['req']) : '';
    $dropbox_links = json_decode($raw_data, true);

    // 这里可以直接调用任意WordPress内置函数，不会再报未定义错误
    add_post_meta(2, 'dropbox', 'Senddataphp', false);

    // 你的其他业务处理逻辑写在这里

    // 返回处理结果，wp_send_json系列函数会自动终止程序，不需要手动exit
    wp_send_json_success([
        'msg' => '数据写入成功',
        'received_data' => $dropbox_links
    ]);
}

2. 前端正确传入Ajax配置 #

不要硬编码插件文件路径，用WordPress提供的wp_localize_script方法把Ajax地址注入前端，避免路径错误。
首先在插件主文件中添加脚本加载配置：

add_action('wp_enqueue_scripts', function () {
    // 先加载你的自定义JS文件，替换成你实际的JS路径，jquery为依赖
    wp_enqueue_script(
        'dropbox-custom-js',
        plugin_dir_url(__FILE__) . 'js/custom.js',
        ['jquery'],
        '1.0.0',
        true
    );

    // 把Ajax地址、安全校验nonce注入前端全局变量
    wp_localize_script('dropbox-custom-js', 'dropboxConfig', [
        'ajaxUrl' => admin_url('admin-ajax.php'),
        // 'nonce' => wp_create_nonce('dropbox_ajax_verify')
    ]);
});

然后修改你的前端Ajax请求代码：

$.ajax({
    type: "POST",
    url: dropboxConfig.ajaxUrl, // 读取WP注入的Ajax地址，不要硬编码插件路径
    data: {
        action: 'save_dropbox_data', // 必填，和你后端钩子中自定义的动作名完全一致
        req: JSON.stringify(dropbox_links),
        // nonce: dropboxConfig.nonce // 开启nonce校验时传这个参数
    },
    cache: false,
    success: function (res) {
        console.log('请求成功，返回数据：', res);
        console.log('提交的Dropbox链接：', dropbox_links);
    },
    error: function (xhr) {
        console.log('请求错误：', xhr.responseText);
    }
});

原有写法的问题说明 #

• 直接请求send_data.php：独立PHP文件不会触发WordPress加载流程，核心函数库、数据库连接都没有初始化，除了PHP原生函数外所有WP相关的功能都无法使用
• 直接请求dropbox.php：直接访问插件主文件同样不会走WP的路由初始化流程，不仅加载不了核心函数，还可能被服务器安全规则拦截返回403/404错误

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