Golang构建Shopify GraphQL查询时动态传入gid值失败求助

问题说明 #

硬编码GID值构建Shopify GraphQL查询时可正常返回结果，但通过动态变量queryId直接拼接查询字符串后，请求返回空响应，查询异常。相同逻辑的Python字符串格式化写法可正常运行，需解决Golang中的该问题。

正常工作的硬编码Golang代码 #

payload := strings.NewReader(`query {
        node(id: "gid://shopify/BulkOperation/2000000011111") {
          ... on BulkOperation {
                url
                partialDataUrl
                }
            }
        }`)

异常的动态拼接Golang代码 #

s := `query {
        node(id: "` + queryId + `") {
          ... on BulkOperation {
                url
                partialDataUrl
                }
            }
        }`

client := &http.Client{}
req, err := http.NewRequest(method, url, strings.NewReader(s))

正常工作的Python代码 #

data_query = '''
    query {
      node(id: "%s") {
        ... on BulkOperation {
          url
          partialDataUrl
        }
      }
    }
    ''' % bulkopr_id

解决办法 #

方法1：使用fmt.Sprintf替代直接字符串拼接 #

直接用+拼接字符串时，若queryId包含特殊字符（如转义符、引号）会破坏查询结构。改用fmt.Sprintf进行格式化，逻辑与Python的%格式化一致：

import "fmt"
import "strings"

// ...

s := fmt.Sprintf(`query {
        node(id: "%s") {
          ... on BulkOperation {
                url
                partialDataUrl
                }
            }
        }`, queryId)

client := &http.Client{}
req, err := http.NewRequest(method, url, strings.NewReader(s))

方法2：使用GraphQL变量（推荐方案） #

Shopify GraphQL支持变量传参，这是更规范的实现方式，可彻底避免字符串拼接带来的潜在问题：

import "encoding/json"
import "bytes"

// ...

// 定义带变量的查询模板
queryTemplate := `query GetBulkOperation($id: ID!) {
        node(id: $id) {
          ... on BulkOperation {
                url
                partialDataUrl
                }
            }
        }`

// 构建请求体，包含查询语句和变量
requestBody := map[string]interface{}{
    "query": queryTemplate,
    "variables": map[string]string{
        "id": queryId,
    },
}

// 序列化为JSON格式
jsonBody, err := json.Marshal(requestBody)
if err != nil {
    // 处理序列化错误
}

client := &http.Client{}
req, err := http.NewRequest(method, url, bytes.NewBuffer(jsonBody))
// 必须设置Content-Type为application/json
req.Header.Set("Content-Type", "application/json")

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