为何Web Service请求在浏览器正常，用jQuery调用却报错？

以下是几个常见的原因和对应的解决方法：

1. 数组参数的序列化格式不匹配 #

Moodle的REST接口要求数组参数以values[0]、values[1]的形式传递，但jQuery默认会将数组values: ['99999999']序列化为values[]=99999999，这种格式不符合接口要求，导致参数无效。

解决方法：

• 显式指定参数键名：

  $.ajax({
    url: 'https://example.com/webservice/rest/server.php',
    type: 'GET',
    data: {
      wstoken: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
      moodlewsrestformat: 'json',
      wsfunction: 'core_user_get_users_by_field',
      field: 'username',
      'values[0]': '99999999'
    },
    success: function(res) { console.log(res); }
  });
  

• 或者启用traditional选项禁用深度序列化：

  $.ajax({
    url: 'https://example.com/webservice/rest/server.php',
    type: 'GET',
    data: {
      wstoken: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
      moodlewsrestformat: 'json',
      wsfunction: 'core_user_get_users_by_field',
      field: 'username',
      values: ['99999999']
    },
    traditional: true, // 关键：保持数组参数的原始格式
    success: function(res) { console.log(res); }
  });
  

2. 请求方式不匹配 #

浏览器地址栏发起的是GET请求，如果你用jQuery发起POST请求，Moodle接口对POST参数的解析规则可能不同，尤其是未正确设置Content-Type时。

解决方法：

• 保持请求方式与浏览器一致（GET）；
• 若必须用POST，确保参数以application/x-www-form-urlencoded格式传递（jQuery默认格式），且参数结构与GET一致。

3. 检查请求参数的实际传递内容 #

在Firefox调试器的「网络」面板中，查看jQuery请求的参数列表，对比浏览器地址栏的参数：

• 确认wstoken、wsfunction等参数无拼写错误；
• 确认数组参数的格式与浏览器地址栏完全一致（比如是否是values[0]而非values[]）。

4. Content-Type设置错误 #

如果手动设置了contentType: 'application/json'，但参数仍以urlencoded格式传递，接口无法解析参数会返回错误。此时需改为传递JSON字符串：

$.ajax({
  url: 'https://example.com/webservice/rest/server.php',
  type: 'POST',
  contentType: 'application/json',
  data: JSON.stringify({
    wstoken: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    moodlewsrestformat: 'json',
    wsfunction: 'core_user_get_users_by_field',
    field: 'username',
    values: ['99999999']
  }),
  success: function(res) { console.log(res); }
});

注意：部分Moodle版本可能需要额外配置才能支持JSON格式的POST参数。

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