CakePHP无刷新提交AJAX请求控制器无法识别请求问题咨询

核心原因 #

CakePHP 框架对$this->request->is('ajax')的判断依赖请求头中的X-Requested-With: XMLHttpRequest标识，默认jQuery AJAX会携带该标识，但如果请求被重定向、路由匹配异常或者AJAX配置有问题，都会导致标识丢失，框架就无法识别为AJAX请求。另外你当前控制器的判断逻辑顺序错误，也会导致输出结果不符合预期。

修复步骤 #

1. 修正前端AJAX代码 #

主动添加AJAX标识请求头，修复多余的语法错误，同时指定返回数据类型：

$('#category_id').change(function(){
    $('.typecategories-select').fadeIn('slow');
    var category_data = $(this).val();
    console.log(category_data);
    $.ajax({
        type: "POST",
        url: '<?php echo $this->Url->build(['controller' => 'Products', 'action' => 'add','plugin'=>'admin'], ['fullBase' => true]); ?>',
        headers: {
            'X-Requested-With': 'XMLHttpRequest'
        },
        data: {category_id:category_data},
        dataType: 'text',
        success: function(data){
            console.log('AjaX Success', data);
        },
        error: function(){alert('AjaX Failed')}
    });
});

注意：添加fullBase参数生成绝对路径避免重定向，删除了原代码末尾多余的闭合花括号。

2. 修正后端控制器逻辑 #

调整判断顺序，优先处理AJAX请求，同时关闭自动视图渲染避免输出多余内容：

public function add()
{
    // 优先判断AJAX请求
    if ($this->request->is('ajax')) {
        $categoryId = $this->request->getData('category_id');
        // 这里可以写查询对应子分类的逻辑
        $this->autoRender = false; // 关闭视图渲染
        echo json_encode(['status' => 'success', 'category_id' => $categoryId]);
        exit; // 终止后续代码执行
    }

    // 普通POST/GET请求的原有新增产品逻辑写在这里
    // ...
}

注意：原有代码的多个if判断没有互斥处理，即使是AJAX请求也会执行后续普通请求的判断逻辑，会导致输出混乱。

3. 排查验证 #

打开浏览器开发者工具的「网络」面板，触发AJAX请求后检查：

• 请求状态码为200，没有出现301/302重定向
• 请求头中存在X-Requested-With: XMLHttpRequest
• 返回内容只有控制器输出的对应数据，没有多余的页面HTML内容

内容的提问来源于stack exchange，提问作者Вербуховський Кирил