Shopify Function 升级 API 版本后报 schema 不匹配

现象#

把 shopify.extension.toml 的 api_version 调高后，本地构建报输入类型不存在或字段被移除。

原因#

• 新版本删改了 input query 里的字段
• 依赖的 schema.graphql 未重新生成
• Function 的 target 在新版本中改名

处理步骤#

1. 用 shopify app function schema 重新拉取对应版本 schema
2. 对照 changelog 逐个替换废弃字段
3. 确认 toml 里的 target 与版本匹配
4. 本地跑 shopify app function run 用样例输入验证

验收标准#

构建通过，本地运行输出正确，部署后线上行为与本地一致。