Golang Machinebox GraphQL mutation传嵌套JSON变量遇错

• 原有Mutate函数的入参硬编码为map[string]string，只适配所有值都是字符串的单层传参场景，只要嵌套层是对象/数组结构，根本没法存进string类型的容器，直接触发类型不匹配报错。
• 之前尝试把struct转成JSON字符串传入的方案有本质问题：转成字符串后，GraphQL服务端收到的data是个纯字符串，和Schema要求的WfLogCreateInput对象类型不匹配，直接被服务端拦下报类型错误。
• 用struct传参时如果不带对应JSON tag，Go导出的大写字段会被序列化成大驼峰格式，和GraphQL定义的小驼峰字段名对不上，也会触发参数校验失败。

• 第一步：调整Mutate函数的入参类型，从写死的map[string]string改成通用的interface{}，兼容任意层级的嵌套传参，去掉多余的类型约束：

func Mutate(data interface{}, mutation string) interface{} {
    client := GQLClient()

    graphqlRequest := graphql.NewRequest(mutation)
    // 直接把传入的嵌套结构交给Var方法，库内部会自动完成JSON序列化
    graphqlRequest.Var("data", data)

    var graphqlResponse interface{}
    if err := client.Run(context.Background(), graphqlRequest, &graphqlResponse); err != nil {
        panic(err)
    }

    return graphqlResponse
}

• 第二步：按照GraphQL Schema的结构要求，构造匹配的入参，两种写法都能正常跑：
  1. 定义带准确JSON tag的struct，结构和嵌套层级完全对齐Schema：

// 每个字段的json tag必须和GraphQL Schema的字段名完全一致
type TaskConnectInput struct {
    ID string `json:"id"`
}
type TaskGUIDInput struct {
    Connect TaskConnectInput `json:"connect"`
}
type WfLogCreateInput struct {
    Event     string        `json:"event"`
    TaskGUID  TaskGUIDInput `json:"taskGUID"`
    Log       string        `json:"log"`
    CreatedBy string        `json:"createdBy"`
}

2. 直接构造嵌套的map[string]interface{}结构，不需要提前写struct定义，灵活度更高：

// 只要层级、字段名和Schema完全对齐即可
input := map[string]interface{}{
    "event": "Task Create",
    "taskGUID": map[string]interface{}{
        "connect": map[string]interface{}{
            "id": "606f46cdbbe767001a3b4707",
        },
    },
    "log":       "my log and information",
    "createdBy": "calvin cheng",
}

• 第三步：把构造好的入参直接传给Mutate方法就行，不要额外做JSON序列化转字符串的操作。

• 绝对不要把struct或者嵌套map先转成JSON字符串再传给Var方法：这种操作会让服务端收到的data是纯字符串，不是要求的对象结构，100%触发类型校验失败。
• 用struct传参必须补全所有字段的json tag，比如TaskGUID字段如果不加json:"taskGUID"，序列化后会变成TaskGUID，和Schema里的字段名对不上，服务端根本识别不到。
• 遇到不确定的传参错误时，可以直接打印客户端实际发出的请求体，检查variables字段的结构、字段名是否和Schema要求完全对齐，绝大多数传参错误都是字段名拼写不对、层级不匹配导致的。

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