Ruby Grape：传递哈希数组参数报错，如何正确发送？

我尝试向API发送一个哈希数组参数：

[{question_id: 1_id, answer:1_String},{question_id: 2_id, answer:2_String}]

在API的定义文件中，我写了这样的代码：

requires :profile_setting, type: Array[Hash], desc: "[{question_id: 1_id, answer: '1_String'},{question_id: 2_id, answer: '2_String'}]"

实际传递的参数和上面的示例一致，但收到了错误响应：

{ "error": "profile_setting is invalid" }

请问该如何正确发送这个由多个哈希组成的数组参数？

问题排查与解决方案 #

咱们一步步拆解问题，从最常见的原因入手：

1. 先修正参数的基础格式

你示例里的1_id和1_String看起来像是未定义的变量标识符，这会直接导致参数格式不合法。API接收的应该是具体的值，比如字符串或数字：

# 正确的参数结构示例
[{question_id: 1, answer: "1_String"}, {question_id: 2, answer: "2_String"}]

如果question_id是字符串类型，就写成question_id: "1"，确保所有值都是API能识别的合法类型。

2. 确认请求的编码方式

不同的HTTP请求类型，数组哈希参数的传递格式差异很大：

• POST请求（JSON格式）：必须把请求头Content-Type设为application/json，参数以JSON字符串传递：

{
  "profile_setting": [
    {"question_id": 1, "answer": "1_String"},
    {"question_id": 2, "answer": "2_String"}
  ]
}

• POST请求（表单格式）：部分框架支持表单编码的数组哈希，格式如下：

profile_setting[][question_id]=1&profile_setting[][answer]=1_String&profile_setting[][question_id]=2&profile_setting[][answer]=2_String

• GET请求：直接把上述表单格式的参数拼在URL末尾即可。

3. 优化API的校验规则（以Grape框架为例）

如果你的API用的是Grape这类框架，单纯的Array[Hash]校验太宽泛，建议给哈希内的字段添加具体校验，这样能返回更精准的错误信息：

requires :profile_setting, type: Array do
  requires :question_id, type: Integer # 根据实际需求设为String或其他类型
  requires :answer, type: String
end

这样如果某个字段类型不匹配，错误日志会明确告诉你是question_id还是answer出了问题。

4. 查看服务器错误日志

如果上面的方法都没解决，一定要去看API服务器的错误日志——日志里通常会有详细的错误原因，比如“缺少answer字段”“question_id类型应为整数”，这能帮你快速定位问题。

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