WordPress多AJAX脚本入队遇500错误的调试方案

问题现状 #

第一个AJAX脚本（my-ajax-script.js）运行正常，第二个脚本（fav-ajax-script.js）始终返回500内部服务器错误，核心怀疑点是本地化变量重复覆盖。

核心问题定位 #

你在functions.php中两次调用wp_localize_script时，都使用了**my_ajax_obj**作为全局变量名。由于后加载的脚本会覆盖先加载的变量，第二个脚本实际拿到的是第一个脚本的nonce值，而PHP处理函数验证的是tutorial_nonce_value，最终导致nonce验证失败，触发500错误。

调试步骤 #

• 查看全局变量值：打开浏览器开发者工具（F12）→ 控制台，执行console.log(my_ajax_obj)，确认输出的nonce是否和第二个脚本预期的一致。
• 开启WordPress调试模式：在wp-config.php中添加以下代码，生成详细错误日志：

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

错误日志会保存在wp-content/debug.log中，里面会明确显示nonce验证失败的具体信息。

• 检查AJAX请求响应：在开发者工具→网络标签，找到tutorial_fav_toggle的请求，查看响应体中的错误提示，直接定位问题。

修复方案 #

给两个脚本分配独立的本地化变量名，避免覆盖：

1. 修改functions.php中的本地化配置 #

add_action( 'wp_enqueue_scripts', 'enqueue_ajax_scripts' );
function enqueue_ajax_scripts() {

  wp_enqueue_script( 'ajax-script', get_template_directory_uri() . '/js/my-ajax-script.js', array('jquery') );
  wp_localize_script( 'ajax-script', 'lesson_ajax_obj',
          array( 'ajax_url' => admin_url( 'admin-ajax.php' ),
                 'nonce'    => wp_create_nonce( 'lesson_nonce_value' ),
          ) 
        );

  wp_enqueue_script( 'ajax-script2', get_template_directory_uri() . '/js/fav-ajax-script.js', array('jquery') );
  wp_localize_script( 'ajax-script2', 'tutorial_ajax_obj',
          array( 'ajax_url' => admin_url( 'admin-ajax.php' ),
                 'nonce'    => wp_create_nonce( 'tutorial_nonce_value' ),
          ) 
        );
}

2. 修改my-ajax-script.js的变量引用 #

function lesson_watched_call(lesson_id_value) {  
    console.log('Lesson watched fn called.');
    console.log(lesson_id_value);
    $.post(lesson_ajax_obj.ajax_url, {
        _ajax_nonce: lesson_ajax_obj.nonce,  // nonce
        action: "lesson_watched", // action call
        lesson_value: lesson_id_value // data
    });
}

3. 修改fav-ajax-script.js的变量引用 #

function toggleFavTut(tutorial_id_value) {  
    console.log('Tutorial toggle fn called.');
    console.log(tutorial_id_value);
    $.post(tutorial_ajax_obj.ajax_url, {
        _ajax_nonce: tutorial_ajax_obj.nonce,  // nonce
        action: "tutorial_fav_toggle", // action call
        tutorial_value: tutorial_id_value // data
    });
}

额外优化建议 #

如果不想维护多个全局变量，可以合并本地化配置，用不同的key区分nonce：

wp_localize_script( 'ajax-script', 'site_ajax_obj',
  array( 
    'ajax_url' => admin_url( 'admin-ajax.php' ),
    'lesson_nonce' => wp_create_nonce( 'lesson_nonce_value' ),
    'tutorial_nonce' => wp_create_nonce( 'tutorial_nonce_value' )
  ) 
);

之后JS中分别使用site_ajax_obj.lesson_nonce和site_ajax_obj.tutorial_nonce即可。

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