Shopify GraphQL Admin API：首个变体已存在错误排查求助

问题核心原因 #

当你创建一个无自定义属性的Shopify产品时，系统会自动生成一个默认的基础变体（即首个变体）。此时如果你再调用productVariantCreate去创建第一个变体，就会触发“已存在”的冲突提示。

分步解决方法 #

1. 先检查并更新默认变体，而非重复创建 #

创建产品后，先通过查询确认是否存在默认变体，若存在则直接修改它的价格、库存等属性：

# 查询产品的默认变体
query GetProductDefaultVariant($productId: ID!) {
  product(id: $productId) {
    id
    firstVariant {
      id
      price
      inventoryQuantity
      sku
    }
  }
}

如果返回的firstVariant不为空，使用productVariantUpdate突变修改属性：

# 更新默认变体的价格、库存
mutation UpdateProductVariant($variantId: ID!, $input: ProductVariantInput!) {
  productVariantUpdate(id: $variantId, input: $input) {
    productVariant {
      id
      price
      inventoryQuantity
    }
    userErrors {
      field
      message
    }
  }
}

示例输入参数：

{
  "variantId": "gid://shopify/ProductVariant/123456789",
  "input": {
    "price": "29.99",  # 注意：价格必须传字符串格式
    "inventoryQuantity": 100,
    "sku": "PROD-SKU-001"
  }
}

2. 若需创建多属性变体，先配置产品选项再批量创建 #

如果你的产品有多个属性（比如颜色、尺寸），先给产品添加选项，再用productVariantsBulkCreate批量创建变体（注意不要包含默认变体）：

# 先给产品添加选项（比如颜色）
mutation AddProductOption($productId: ID!, $input: ProductOptionInput!) {
  productOptionCreate(productId: $productId, input: $input) {
    productOption {
      id
      name
      values
    }
    userErrors {
      field
      message
    }
  }
}

# 批量创建变体（仅新增，不包含默认变体）
mutation BulkCreateVariants($productId: ID!, $variants: [ProductVariantInput!]!) {
  productVariantsBulkCreate(productId: $productId, variants: $variants) {
    productVariants {
      id
      price
      selectedOptions {
        name
        value
      }
    }
    userErrors {
      field
      message
    }
  }
}

示例批量变体输入：

{
  "productId": "gid://shopify/Product/987654321",
  "variants": [
    {
      "price": "39.99",
      "inventoryQuantity": 50,
      "selectedOptions": [{"name": "Color", "value": "Red"}]
    },
    {
      "price": "39.99",
      "inventoryQuantity": 30,
      "selectedOptions": [{"name": "Color", "value": "Blue"}]
    }
  ]
}

3. 新手避坑要点 #

• 价格、成本等金额字段必须传字符串，不能直接传数字
• 确保API密钥拥有write_products权限
• 库存数量修改受产品inventoryPolicy影响：DENY模式下不允许库存为负，ALLOW模式则无限制
• 批量创建变体时，单次最多提交100个变体，超出会触发报错

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