WordPress admin-ajax返回200成功但响应文本为0 已配wp_die仍无效

问题现状 #

• 已尝试各类公开的常见修复方案：在自定义处理函数末尾添加die()、使用echo true做输出验证，操作后均不生效
• 业务逻辑本身非常简单，始终无法定位根因，最终向admin-ajax.php发起的请求返回200成功状态，但前端success回调函数获取到的响应文本始终为0

完整实现代码 #

前端HTML表单 #

<form id="formRangeYStand">
    <div class="range" id="range_y_stand">
        <input type="range" min="1" max="5" steps="1" value="1" id="range_y_stand_input" name="range_y_stand_input">
    </div>
    <ul class="range-labels" id="range_y_stand_label" style="text-align: left;">
        <li class="active selected"><span></span></li>
        <li style="text-align: center; margin-left: -20px;"><span>Learning</span></li>
        <li><span>Can do</span></li>
        <li style="margin-left: 0px;"><span>Can do well</span></li>
        <li style="margin-left: -4px; text-align: right;"><span>Mastered</span></li>
    </ul>
    <button type="submit" style="margin-top: 20px">Submit</button>
</form>

前端提交逻辑JS #

Query("#formRangeYStand").submit(function () {
    event.preventDefault();
    var link = '/wp-admin/admin-ajax.php';
    var form = jQuery("#formRangeYStand").serialize();
    var formData = new FormData;
    formData.append('action', 'testiram');
    formData.append('testiram', form);
    jQuery.ajax({
        url: link,
        data: formData,
        contentType: false,
        processData: false,
        type: 'post',
        success: function (result) {
            alert(result);
        },
        error: function (error) {
            console.log(error);
        }
    });
    return false;
});

后端处理PHP（放置于主题functions.php） #

add_action('wp_ajax_testiram', 'testiram');
add_action('wp_ajax_nopriv_testiram', 'testiram');
function testiram() {
    echo true;
    wp_die();
}

核心根因与修复点 #

按照出现概率从高到低排查：

• FormData初始化写法不规范：代码里new FormData没有加括号，虽然现代浏览器大多能容错，但部分环境下会导致实例创建异常，后续append的参数根本没有附加到请求体里，WordPress收不到action=testiram的参数，匹配不到对应的处理函数，就会默认返回0。修复时直接改成new FormData()即可。
• 钩子未被成功加载注册：如果functions.php中存在PHP语法错误、提前执行的exit/die语句、主题/插件的加载逻辑中断，会导致两个add_action的钩子根本没有被注册到WordPress的钩子系统里。验证方法很简单：在testiram函数的第一行加echo 'function loaded'; wp_die();，发请求如果看不到这个输出，就说明钩子压根没加载，回头检查functions.php的代码错误即可。
• 参数匹配错误：检查add_action的钩子后缀和前端传的action参数是否完全大小写一致，不能有多余空格、不可见字符——哪怕差一个字母、一个大小写不匹配，WordPress都会匹配不到函数直接返回0。
• 缓存干扰：站点如果装了页面缓存插件、CDN缓存，很容易把admin-ajax.php之前返回的0值缓存下来，后续的请求直接读缓存。可以给ajax请求的url加个随机时间戳参数（比如var link = '/wp-admin/admin-ajax.php?_t=' + Date.now();）跳过缓存再测试。
• 提交监听未生效：代码第一行用的自定义Query别名，如果别名定义的时机晚于这段提交逻辑的执行时间，会导致submit监听压根没绑到表单上。如果实际请求能正常发出，可以跳过这步，否则要把JS代码挪到jQuery和自定义Query别名定义完成之后再执行。
• 附带无关提示：HTML里range输入框的steps属性写法有误，标准属性名是step，写错了会导致滑块步长控制失效，但不会影响ajax的返回结果。

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