Shopify Functions
Functions 跑在 Shopify 的沙箱里，输入靠 GraphQL 查询声明、输出靠固定的 operation 结构，任何一环写错都会表现为「部署成功但不生效」。本分类说明折扣函数不出现在后台、输入查询字段超限、Wasm 编译失败与运行时错误的具体成因和排查顺序。
-
01
shopify app deploy 成功了函数却还是旧版本
CLI 显示 deploy 完成、版本号也递增，线上结账仍按旧规则算……
-
02
shopify app function run 传 JSON 报错
把线上日志里的 input 存成 input.json……
-
03
Shopify Cart Transform 做捆绑后金额仍是原价怎么查
买 3 件捆绑价 199 的规则上线后，购物车三条明细合并成一条，标题也换了，但结账金额还是三件原价之和……
-
04
Shopify 购物车校验函数在 POS 与订阅续订上不生效
后台 设置 → 结账 里已启用校验项，线上普通结账能拦住超量下单……
-
05
Shopify 配送与支付定制函数能改到哪一层
在 设置 → 配送和送达 的配送自定义里启用隐藏规则，货到付款仍然出现在结账页；改成重命名后……
-
06
Shopify Function 升级 API 版本后报 schema 不匹配
把 shopify.extension.toml 的 api_version 调高后……
-
07
Shopify Function 读不到 $app metafield
输入查询写了 metafield(namespace: "$app:rules", key: "config")……
-
08
Shopify 折扣 Function 自动应用和折扣码怎么共存
自动折扣生效后，客户再输入折扣码，两者互相覆盖或都不生效。
-
09
Shopify Function 取不到 variant 字段与行属性
输入查询只写了 cart.lines { merchandise { id } }……
-
10
Shopify Cart Transform 合并行项目不生效怎么查
配置了 bundle 合并逻辑，结账页仍然按单件显示，赠品没有合并成一组。
-
11
Shopify Function 改了配置线上还是旧规则
后台把满减门槛从 199 改成 299，前台 250 元的购物车仍在减钱……
-
12
Shopify Function 多币种折扣金额算错怎么办
美元店铺折扣正常，切到日元后折扣金额出现小数或差几分钱。
-
13
Shopify Function 部署成功却不生效
部署显示成功，结账却无折扣/运费变化。
-
14
Shopify Function 折扣不显示怎么办
折扣 Function 已部署，后台「折扣」里找不到该应用折扣，或创建时列表为空。
-
15
多个 Function 折扣叠加顺序怎么控制
两个折扣函数同时生效时，最终金额比预期低很多，或某个折扣完全没起作用。
-
16
Shopify 折扣 Function 百分比单位写错
想打九折，代码里写 percentage: { value: 0.1 }，结账页只减了几毛钱……
-
17
Function 抛错导致结账中断怎么排查
进入结账页后提示「无法计算运费/折扣」，无法继续付款；移除函数后恢复正常。
-
18
Shopify Function 出错时该返回错误还是直接抛异常
Function 内部校验失败直接抛异常，导致整个结账报错中断，客户无法下单。
-
19
Shopify Function 按条件隐藏支付方式怎么做
希望 B2B 客户只看到账期付款，零售客户看不到，但配置后所有客户都只剩一种方式。
-
20
Shopify Function 怎么隐藏某些配送方式
想对偏远地区隐藏快递选项，只保留平邮，但配置后所有方式都消失了。
-
21
Shopify Function 输入查询成本超过 30 点怎么压
输入查询里给每条 cart line 都取了 product 的两个 metafield 和 hasAnyTag……
-
22
Shopify Function 输入查询字段过多怎么优化
部署或运行报 input query 过复杂/字段过多，或编译警告。
-
23
Shopify Function 指令数超限后折扣不生效
大促期间 180 行的批发购物车进结账，折扣完全不出现；同一函数在 20 行的购物车里正常……
-
24
Shopify Function 本地怎么调试输入输出
只能部署后看结果，出问题不知道是输入没取到还是逻辑写错。
-
25
Shopify Function 本地测试数据不对怎么构造
本地 function run 的输入里商品、购物车都是空的，测不出分支逻辑。
-
26
Shopify Function metafield 超限变 null
限购规则从 80 条加到 300 条后，函数不再拦任何超量购物车；后台 metafield 值还在……
-
27
Shopify Function 读不到 metafield 怎么办
Function 里查询商品或购物车属性上的 metafield，返回一直是空；后台明明已经填了值。
-
28
Shopify Function operations 写错无变化
本地 run 的输出看起来有内容，前台购物车完全没变化……
-
29
Shopify Function 的结果怎么传给结账页显示
Function 算出了赠品或提示文案，但结账页看不到任何说明。
-
30
Shopify Function 禁用随机数与时间
函数里用 Date.now() 判断活动是否开始，部署后运行直接失败……
-
31
Shopify Function 读不到购物车属性怎么办
Function 里判断 cart.attribute 总是 null，前端明明已经写入了自定义字段。
-
32
Shopify Function 部署了新版本但线上还是旧逻辑
改了代码并 deploy，线上折扣行为没变，本地却已生效。
-
33
Shopify Function 店铺 metafield 读不到
规则 JSON 写在店铺级 metafield 上……
-
34
Shopify Function 执行超时被中断怎么优化
Function 在本地跑得好，线上结账时折扣偶尔不生效，日志显示执行超出时间预算。
-
35
Shopify 校验 Function 返回了 errors 结账却不拦
函数里 push 了三条错误，结账页一条都没出现……
-
36
Shopify Function Wasm 编译失败怎么排查
shopify app function build 或部署时 Wasm 编译失败，CI 红灯。
-
37
shopify app function run 跑旧 wasm
改了 run.js 里的判断条件，本地 run 的输出和修改前一模一样……
-
38
Shopify Scripts 的 cart_line 改价逻辑怎么改写
原脚本遍历 cart.line_items 把 tag 为 gift 的行单价改成 0，迁移后赠品仍按原价计费……
-
39
Shopify 脚本迁移到 Function 后折扣被算了两次
迁移完成后同一笔订单出现两条相同减免，一条来自自动折扣、一条来自折扣码；订单详情里的折扣合计正好是原来的两倍。
-
40
Shopify Scripts 停用后旧结账逻辑往哪迁
Script Editor 里还有 6 个脚本在跑，后台提示 2026 年 6 月 30 日后不再执行……
