WordPress使用wp_enqueue_scripts为指定文章加载脚本失败求助

问题根因 #

1. 嵌套钩子不生效的原因 #

WordPress的动作钩子是按注册优先级依次执行的，wp_enqueue_scripts默认优先级为10。你在优先级为10的load_custom_shortcode_scripts回调中，再注册同优先级的wp_enqueue_scripts回调时，该优先级的队列已经执行完毕，新增的回调不会被触发，因此脚本无法加载。

2. 修改后AJAX返回400的原因 #

admin-ajax.php的请求上下文不属于前端文章页面，你将包含AJAX处理钩子的script-208.php放在is_single(208)条件内加载，AJAX请求时该判断返回false，对应的wp_ajax_*/wp_ajax_nopriv_*钩子未注册，WordPress找不到对应action的处理逻辑，就会返回400错误。

可行解决方案 #

方案1：固定文章ID加载（兼容现有逻辑） #

将AJAX处理逻辑和脚本加载逻辑拆分，AJAX处理逻辑全局注册，脚本加载仅在指定文章页面触发：

1. 调整custom-shortcodes.php代码：

// 全局加载AJAX处理文件，不受页面条件限制
require("files-208/script-208.php");

function load_custom_shortcode_scripts(){
    if(is_single(208)){
        wp_register_script( "gamescript_stroop", get_stylesheet_directory_uri() . '/assets/shortcodes/stroop/stroop.js', array('js-jquery') );
        wp_localize_script( 'gamescript_stroop', 'ajaxLoad', array( 
            'ajaxUrl' => admin_url( 'admin-ajax.php' ),
            // 替换为你实际的AJAX action名
            'action' => 'your_stroop_action'
        ));
        wp_enqueue_script( 'gamescript_stroop' );
    }
    // 后续其他文章判断可在此添加
}
add_action( 'wp_enqueue_scripts', 'load_custom_shortcode_scripts', 10 );

2. 调整script-208.php代码，仅保留AJAX处理逻辑：

// 全局注册AJAX处理钩子，替换为你实际的action名和处理函数
add_action('wp_ajax_your_stroop_action', 'stroop_ajax_handler');
add_action('wp_ajax_nopriv_your_stroop_action', 'stroop_ajax_handler');
function stroop_ajax_handler(){
    // 这里放你原有的AJAX处理逻辑
    // 处理完成后必须调用wp_die()结束请求
    wp_die();
}

方案2：短代码自动加载脚本（更灵活，无需硬写文章ID） #

因为你提到文章内容通过短代码渲染，可以直接在短代码回调中加载脚本，只有使用了对应短代码的文章才会加载脚本，不需要手动判断文章ID：

// 注册短代码，替换为你实际的短代码名
add_shortcode('stroop_game', 'stroop_shortcode_render');
function stroop_shortcode_render($atts){
    // 短代码被调用时再加载对应脚本
    wp_register_script( "gamescript_stroop", get_stylesheet_directory_uri() . '/assets/shortcodes/stroop/stroop.js', array('js-jquery') );
    wp_localize_script( 'gamescript_stroop', 'ajaxLoad', array( 
        'ajaxUrl' => admin_url( 'admin-ajax.php' ),
        'action' => 'your_stroop_action'
    ));
    wp_enqueue_script( 'gamescript_stroop' );

    // 这里返回你原有的短代码渲染内容
    return '<div id="stroop-game-wrap"></div>';
}

// 全局注册AJAX处理逻辑
add_action('wp_ajax_your_stroop_action', 'stroop_ajax_handler');
add_action('wp_ajax_nopriv_your_stroop_action', 'stroop_ajax_handler');
function stroop_ajax_handler(){
    // 原有AJAX处理逻辑
    wp_die();
}

两种方案都可以实现仅特定页面加载脚本，同时解决AJAX 400的问题。

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