Drupal自定义模块中分页AJAX功能报错排查求助

错误根源 #

这个“文件大小超限”的提示是误导性错误，实际是手动编写的AJAX请求不符合Drupal表单AJAX规范，导致请求被异常处理。具体问题：

• 缺少CSRF令牌验证：Drupal所有POST请求都需要携带CSRF令牌，否则会触发安全校验失败，错误提示偏离实际问题。
• 表单关键参数缺失：手动构造的AJAX数据没有包含Drupal表单必需的_build_id、_token等参数，系统无法识别这是合法的表单请求。
• JS中PHP变量拼接错误：mainCondition: '".$mainCondition."'是PHP语法，直接写在JS字符串里会导致参数值变成字面量".$mainCondition."，而非实际变量值。
• URL构造不规范：硬编码AJAX URL不符合Drupal路由机制，容易导致路由匹配失败。

修复步骤 #

1. 用Drupal原生AJAX机制替代手动jQuery请求（推荐） #

不要自己写原生jQuery AJAX，改用Drupal提供的#ajax机制处理分页：

// 生成分页时，构建带AJAX属性的链接
$next_url = Url::fromRoute('your_module.clinical_trial', [
  'page' => $currentPage + 1,
  'mainCondition' => $mainCondition,
]);
$next_link = [
  '#type' => 'link',
  '#title' => $this->t('Next'),
  '#url' => $next_url,
  '#attributes' => [
    'class' => ['page-link'],
    'data-drupal-ajax' => 'true',
    'data-ajax-wrapper' => 'result_message',
    'data-ajax-method' => 'POST',
  ],
];
// 渲染后替换原有的HTML分页代码
$html .= \Drupal::service('renderer')->render($next_link);

2. 手动AJAX请求的修复（若坚持用原生JS） #

补充CSRF令牌和表单关键参数，修正变量传递：

// 获取Drupal内置的CSRF令牌和表单_build_id
const csrfToken = Drupal.settings.csrfToken;
const buildId = $('input[name="_build_id"]').val();

// 修正数据构造
var data = {
  currentPage: currentPage,
  pageType: pageType,
  mainCondition: Drupal.settings.clinicalTrial.mainCondition, // 通过Drupal.settings传递变量
  form_id: 'ajax_submit_demo',
  _build_id: buildId,
  _token: csrfToken
};

// 修正AJAX请求
$.ajax({
  type: 'POST',
  data: data,
  url: Drupal.url('clinical-trial'), // 使用Drupal.url生成规范路由
  headers: {
    'X-CSRF-Token': csrfToken
  },
  success: function(response) {
    if (response[0] && response[0].command === 'insert') {
      $('.result_message').html(response[0].data);
    }
    $('#pagination-demo').attr('data-current-page', currentPage);
  }
});

3. 正确传递PHP变量到JS #

用Drupal的#attached机制传递变量，避免直接拼接：

// 在setMessage方法中添加JS设置
$response->addCommand(new HtmlCommand('.result_message', $html));
$response->setAttachments([
  'library' => ['core/drupal.ajax'],
  'drupalSettings' => [
    'clinicalTrial' => [
      'mainCondition' => $mainCondition,
      'currentPage' => 1
    ]
  ]
]);

4. 调试与基础检查 #

• 开启Drupal verbose日志（settings.php中设置$config['system.logging']['error_level'] = 'verbose';），查看真实错误信息。
• 确认clinical-trial路由对应的控制器权限正确，且表单#form_id确实为ajax_submit_demo。

额外建议 #

• 避免直接拼接HTML，改用Drupal渲染数组构建表格和分页，自动处理安全过滤和主题化。
• 使用Drupal的PagerManager处理分页逻辑，避免手动维护页码导致的错误。

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