graphql-go是否缺乏内置的参数与变量传入类型验证机制？

问题背景 #

使用graphql-go构建Golang GraphQL端点时，遇到以下异常情况：

• 定义email为非空字符串参数，但传入数字类型123时，resolve函数中的类型断言未触发错误，最终返回success: true
• 其他场景下，传入与定义类型不匹配的参数（如整数数组参数传入单个整数），也未触发类型错误

相关代码与请求信息如下：

resolver.go代码片段 #

func GetRootMutation(db *gorm.DB, req *http.Request) *graphql.Object {
    rootMutation := graphql.NewObject(graphql.ObjectConfig{
        Name: "RootMutation",
        Fields: graphql.Fields{
            "send_otp_email": SendOtpEmail(db, req),
        },
    })

    return rootMutation
}

func SendOtpEmail(db *gorm.DB, req *http.Request) *graphql.Field {
    return &graphql.Field{
        Type:        graphqlGlobal.ResultType,
        Description: "Send OTP to user's email.",
        Args: graphql.FieldConfigArgument{
            "email": &graphql.ArgumentConfig{Type: graphql.NewNonNull(graphql.String)},
            // 已设置为非空字符串类型
        },
        Resolve: func(params graphql.ResolveParams) (interface{}, error) {
            success := true
            messages := []string{}
            email, isOK := params.Args["email"].(string)
            if !isOK {
                success = false
                // 这里本应触发错误？
                return nil, errors.New(language.GetErrValueInvalid())
            }

            if success {
                userImpl := repository.NewAuthRepo(db, req)
                err := userImpl.SendOtpEmail(email)
                if err != nil {
                    success = false
                    messages = []string{err.Error()}
                }
            }

            message := ""
            if len(messages) > 0 {
                message = messages[0]
            }
            result := map[string]interface{}{"success": success, "messages": messages}
            var errResult error
            if !success {
                errResult = errors.New(message)
            }
            return result, errResult // 居然走到了这里！
        },
    }
}

执行的Mutation操作 #

mutation RootMutation($email: String!) {
  send_otp_email(email: $email) {
    success
    messages
  }
}

传入变量 #

{
  "email": 123
}

返回结果 #

{
  "data": {
    "send_otp_email": {
      "messages": [],
      "success": true
    }
  }
}

问题分析与解答 #

graphql-go是否有内置参数验证？ #

graphql-go是具备内置参数/变量类型验证机制的，你遇到的问题并非验证缺失，而是由以下原因导致：

1. GraphQL规范允许的隐式类型转换
   GraphQL标量类型支持有限的隐式转换，比如数字类型可以被自动转换为字符串类型。当你传入"email":123时，graphql-go会自动将数字转换为字符串"123"，因此params.Args["email"].(string)的类型断言会成功，不会进入错误分支。

2. 请求处理流程可能存在疏漏
   如果传入完全无法转换的类型（如给数组参数传单个整数），正常情况下graphql-go会在执行resolve函数之前就抛出顶层验证错误，不会进入你的resolve逻辑。如果未触发错误，检查以下两点：

   • 是否在执行graphql.Do()时，正确传入了Schema和变量，没有手动绕过验证流程
   • 是否提前对变量做了自定义类型转换，导致GraphQL库无法校验原始输入类型

修复方案 #

1. 实现严格类型校验（禁用隐式转换）

通过自定义标量类型，替换默认的graphql.String，拒绝非字符串输入：

// 自定义严格字符串标量，不允许隐式类型转换
var StrictString = graphql.NewScalar(graphql.ScalarConfig{
    Name:        "StrictString",
    Description: "严格字符串类型，仅接受字符串输入，不支持隐式转换",
    Serialize: func(value interface{}) interface{} {
        str, ok := value.(string)
        if !ok {
            return nil
        }
        return str
    },
    ParseValue: func(value interface{}) interface{} {
        str, ok := value.(string)
        if !ok {
            return nil
        }
        return str
    },
    ParseLiteral: func(valueAST ast.Value) interface{} {
        if strVal, ok := valueAST.(*ast.StringValue); ok {
            return strVal.Value
        }
        return nil
    },
})

然后在参数定义中使用该标量：

Args: graphql.FieldConfigArgument{
    "email": &graphql.ArgumentConfig{Type: graphql.NewNonNull(StrictString)},
},

这样传入数字类型时，graphql-go会在验证阶段抛出错误，不会进入resolve函数。

2. 确保请求处理流程正确

执行GraphQL请求时，使用标准流程，不要忽略错误信息：

// 示例请求处理代码
func handleGraphQL(w http.ResponseWriter, r *http.Request) {
    var reqBody struct {
        Query     string                 `json:"query"`
        Variables map[string]interface{} `json:"variables"`
    }
    if err := json.NewDecoder(r.Body).Decode(&reqBody); err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
        return
    }

    result := graphql.Do(graphql.Params{
        Schema:         YourSchema, // 你的完整Schema
        RequestString:  reqBody.Query,
        VariableValues: reqBody.Variables,
    })

    w.Header().Set("Content-Type", "application/json")
    if len(result.Errors) > 0 {
        // 这里会返回验证错误
        json.NewEncoder(w).Encode(result)
        return
    }
    json.NewEncoder(w).Encode(result)
}

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