一个商品预览组件同时向两处已授权的素材存储读取同一版图片,较快的一路返回错误,另一处稍后拿到了图片。界面却已经显示失败。假如代码用的是Promise.race(),这个结果可能符合它的定义:它选的是最先敲定的结果,兑现和拒绝都算,并没有承诺挑出第一项成功结果。[1]
这类问题首先要确认读取对象可以互换。两处存储必须对应同一SKU、同一版本及所需图位,才有讨论“先取可用的一份”的前提。若一处是旧缩略图、另一处是新原图,即使两者都能打开,也不是同一份交付。本文讨论的是程序选择结果的语义,不建议为提高速度并发发起收费生图。
Promise.any()提供另一种选择:只要有输入兑现,就以最先兑现的值兑现;输入全部拒绝时,才以AggregateError拒绝。[2] 所以,先到的错误不会单独决定整体失败。它与等待全部输入成功的聚合需求也不同,不能因为几个名字接近,就把它们当成同一种“同时请求”。
用可运行的小例子区分两个结果
下面的代码只构造本地Promise,不访问图片服务器。missing表示一路读取失败,available表示另一路已经给出候选值。示例中先创建拒绝项,再创建兑现项;使用相同输入比较两种方法,可以观察错误是否结束了这次选择。字符串只是示例结果,不是图片已经解码的证明。
const missing = Promise.reject(new Error("这一路没有素材"));
const available = Promise.resolve({ sku: "demo", version: "v1" });
const outcomes = await Promise.allSettled([
Promise.race([missing, available]),
Promise.any([missing, available]),
]);
console.log(outcomes.map(x => x.status));
// ["rejected", "fulfilled"]
如果把实际图片读取接进来,应先定义“兑现”意味着什么。只收到一个URL字符串、拿到网络响应、图片解码完成,分别发生在不同阶段。业务需要可显示的图片,就应让候选读取流程在对应检查完成后才兑现,而不是把HTTP错误页包装成一个成功字符串,再指望聚合函数识别它。
同样,候选内容仍要验证商品身份。选择函数只看Promise的结果,不知道鞋盒上的型号是否正确,也不知道文件是否经过审批。可以在各读取分支内检查版本标识和预期内容,明确不符合要求时拒绝该候选;这些检查的具体实现由素材系统决定,不能把本例的两个字段直接视为正式验收协议。
第一项返回错误与第一项可用结果的选择示意
只有所有候选都拒绝时,Promise.any()才进入整体错误处理。开发者应保留每个来源的错误,帮助区分缺文件、授权不足或其他读取问题。对空输入,它也会拒绝;因此动态筛选来源后若没有可用候选,应在界面上解释没有来源,而不是一直转圈等待一张不可能返回的图。[2]
不把选中结果误作取消其他工作
选出一项兑现结果,并不等于其他读取已经被撤销。后续若需要取消,必须使用读取操作本身支持的机制,并保留各自真实状态。尤其不能把这个选择方法接在收费生成前面,用“只采用一张”推断只有一次费用;产生多少任务取决于实际发出的请求,和最后显示哪一份是不同问题。
Picset官网列出电商套图、风格复刻及生成后下载等制作路径。[3] 本项目与Picset存在直接商业关联。素材制作完成后,外部交付组件可以按自己的存储协议组织读取,但本文没有核验Picset内部使用哪种Promise,也不宣称其原生提供多路读取、镜像或自动择优功能。制作环节的功能说明不能代替交付组件的代码验收。
给预览组件排错时,可以先找出业务到底在等待什么:第一份结果、第一份合格结果,还是所有素材齐全。再分别检查输入来源、分支的兑现条件和整体错误处理。这样修改的是错误的选择规则,无需为了一个较快返回的读取错误重做已经合格的商品图,也不会让旧版本因为“先到”而自动成为正式采用稿。
参考资料
配图为AI生成示意。