Shopify商品发布至在线商店时出现权限错误求助

问题重现 #

创建商品后尝试发布至Shopify在线商店，商品已成功创建，但触发以下报错：

Error: Your app doesn't have a publication for this shop.

使用的代码如下：

// Publish the newly created product.
const publishProductRequest = await admin.graphql(
  `#graphql
  mutation publishProduct($id: ID!, $input: [PublicationInput!]!) {
    publishablePublish(id: $id, input: $input) {
      userErrors {
        field
        message
      }
      publishable {
        availablePublicationCount
        publicationCount
        publishedOnCurrentPublication
      }
      shop {
        id
        name
        publicationCount
      }
    }
  }`,
  {
    variables: {
      id: productId,
      input: {
        publicationId: onlineStorePublicationId,
      },
    },
  }
);

const publishProductResponse = await publishProductRequest.json();

return json(publishProductResponse);

社区给出的解决方案是The app needed storefront API access to set the product to Online Store.，下面拆解具体操作步骤：

解决方案步骤 #

1. 配置应用的Storefront API权限

这个解决方案的核心是你的Shopify应用缺少操作商品发布状态的必要权限，需要补全配置：

• 登录Shopify合作伙伴后台，找到你的应用
• 进入「App setup」→「Storefront API permissions」
• 勾选unauthenticated_read_product_listings权限（用于读取商品发布状态），如果需要修改商品，同时勾选products相关的读写权限
• 把应用重新安装到目标店铺，确保新权限生效

2. 修正GraphQL请求的参数格式

你的代码中，input参数传的是单个对象，但mutation定义要求是数组类型的[PublicationInput!]!，这会导致Shopify无法正确解析请求，修改为数组格式：

variables: {
  id: productId,
  input: [
    {
      publicationId: onlineStorePublicationId,
    },
  ],
},

3. 确认onlineStorePublicationId的正确性

如果传入的发布ID无效，也会触发类似报错，先通过查询获取正确的在线商店发布ID：

query getOnlineStorePublication {
  shop {
    publications(first: 10) {
      edges {
        node {
          id
          name
          isOnlineStore
        }
      }
    }
  }
}

筛选出返回结果中isOnlineStore为true的节点ID，作为onlineStorePublicationId传入发布请求。

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