调用Shopify API执行image.save()时触发ResourceNotFound错误的解决方法

问题描述 #

我们通过Shopify API进行新产品注册和已有产品更新操作时，无法完成新产品注册，执行image.save()语句时触发以下错误：

pyactiveresource.connection.ResourceNotFound: Not Found: https://[shop-ulr].myshopify.com/admin/api/2023-01/images.json

相关代码片段：

image = shopify.Image()
image.product_id = product_id
image.src=img['src']
image.alt = img['alt']

...

image.save()   #Error occurred here

解决方案 #

• 确认产品ID有效性
  检查product_id对应的产品是否已成功创建并存在于Shopify店铺中。如果是新产品注册流程，必须确保产品先完成保存并返回有效product_id——若产品未创建就尝试关联图片，会因目标资源不存在触发404错误。

• 检查API版本与依赖库兼容性
  你当前使用的是2023-01版本的Shopify API，确认该版本是否支持当前图片创建逻辑。建议切换至较新的稳定API版本（如2024-01），同时更新pyactiveresource库到最新版本，避免版本不匹配导致的路径解析错误。

• 改用产品关联的图片创建方式
  不要直接创建独立Image对象再关联product_id，而是通过已保存的Product对象操作，更符合Shopify API设计逻辑：

  # 假设product是已保存成功的Product对象
  image = shopify.Image()
  image.src = img['src']
  image.alt = img['alt']
  product.images.append(image)
  product.save()  # 批量保存产品及关联图片
  

  或者显式传入product_id参数调用保存：

  image = shopify.Image()
  image.src = img['src']
  image.alt = img['alt']
  image.save(product_id=product_id)
  

• 验证API权限
  确认你的Shopify API密钥拥有write_products权限，部分场景下权限不足会伪装成资源不存在的404错误。可在Shopify后台的应用设置中检查权限范围。

• 核对店铺域名与路径拼写
  确认错误信息中的店铺域名[shop-ulr]拼写正确，同时检查API路径/admin/api/2023-01/images.json的格式、大小写是否符合Shopify API规范，避免路径错误导致的404。

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