ShopifySharp调用MetaFieldService.ListAsync无法返回自定义Metafields

核心问题 #

调用MetaFieldService.ListAsync()仅返回系统/第三方生成的Metafields，自定义创建的项未被获取到。

排查与解决步骤 #

• 检查API权限
  确保你的Shopify应用已申请并获得对应权限：如果是产品关联的Metafields，需要read_product_metafields权限；如果是全局Metaobjects，需要read_metaobjects权限。在Shopify后台的应用设置页面确认权限状态。

• 添加精准过滤参数
  默认的ListAsync()不会自动筛选自定义Metafields，必须指定资源范围和自定义命名空间。修改代码如下：

  var service = new MetaFieldService(strShop, strKey);
  // 替换为你的实际产品ID和自定义命名空间
  var filter = new MetaFieldListFilter
  {
      OwnerResource = "product",
      OwnerId = 123456789, 
      Namespace = "your_custom_namespace" 
  };
  var metafields = await service.ListAsync(filter);
  

  若自定义Metafield不关联特定资源，可省略OwnerResource和OwnerId，仅保留Namespace过滤。

• 确认Metafield可访问性
  在Shopify后台创建自定义Metafield时，需将“可访问性”设置为「允许所有应用访问」或指定你的应用，否则应用无法读取该字段。

• 修复异步调用方式
  原代码用Task.Run(...).Result容易引发死锁，建议直接在异步方法中调用：

  public async Task<List<MetaField>> FetchCustomMetafields()
  {
      var service = new MetaFieldService(strShop, strKey);
      var filter = new MetaFieldListFilter
      {
          OwnerResource = "product",
          OwnerId = 123456789,
          Namespace = "custom_fields"
      };
      return await service.ListAsync(filter);
  }
  

• 用GraphQL验证字段存在性
  可以通过Shopify GraphiQL Explorer直接查询，确认自定义Metafields是否存在：

  query {
    product(id: "gid://shopify/Product/123456789") {
      metafields(namespace: "custom_fields") {
        edges {
          node {
            key
            value
            type
          }
        }
      }
    }
  }
  

  如果GraphQL能查到结果，说明问题出在代码的过滤逻辑或权限配置上。

内容的提问来源于stack exchange，提问作者Håkan