通过POST调用AppSync Mutation触发MalformedHttpRequestException问题排查

核心问题分析 #

你遇到的问题本质是curl请求体的JSON格式不符合AppSync的GraphQL要求，尤其是AWSJSON类型参数的转义处理出错。AppSync控制台会自动帮你处理AWSJSON的转义逻辑，但手动编写curl命令时需要自行处理双重转义规则。

具体解决步骤 #

1. 明确GraphQL请求体的正确结构 #

AppSync的HTTP POST请求体必须包含query和variables两个核心字段，其中AWSJSON类型的变量需要以转义后的字符串形式传递（因为AWSJSON在GraphQL定义里是字符串类型，而非原生JSON对象）。

正确的请求体示例：

{
  "query": "mutation PublishMessage($message: AWSJSON!) { publish(message: $message) { id content } }",
  "variables": {
    "message": "{\"content\":\"实时更新内容\",\"sender\":\"测试用户\"}"
  }
}

注意：variables中的message值是一个字符串，内部的JSON引号必须用\做转义处理。

2. 修正curl命令的转义问题 #

不同终端的转义规则有差异，推荐两种可靠写法：

• Bash/Zsh终端：用单引号包裹整个请求体，内部双引号用\转义：

  curl -X POST \
    https://your-api-id.appsync-api.your-region.amazonaws.com/graphql \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer your-auth-token" \
    -d '{
      "query": "mutation PublishMessage($message: AWSJSON!) { publish(message: $message) { id content } }",
      "variables": {
        "message": "{\"content\":\"hello\",\"user\":\"test\"}"
      }
    }'
  

• 跨终端通用方案：把请求体存成单独的request.json文件，再用curl加载文件（避免终端转义坑）：

  curl -X POST \
    https://your-api-id.appsync-api.your-region.amazonaws.com/graphql \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer your-auth-token" \
    -d @request.json
  

3. 验证请求体格式合法性 #

可以用本地的jq命令快速校验JSON格式是否正确：

cat request.json | jq .

如果输出正常无报错，说明请求体的JSON语法没问题。

4. 排查其他潜在错误点 #

• 确认请求头Content-Type必须严格为application/json，不能拼写错误；
• 检查Authorization令牌是否有效，且拥有执行该mutation的权限；
• 核对AppSync API端点的区域、API ID是否与控制台一致。

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