发生了什么

用户在小程序里买的是维修类商品。这类商品在系统里有一条商品记录:名称、价格,以及一张展示图。图片文件本身存在图片服务里,商品记录只保存一个指向它的链接。用户下单后打开订单详情或订单列表,页面就拿这条链接去加载商品图片。

正常流程是:商品创建时前端上传图片,图片服务返回一条链接,商品服务把链接存进商品记录;之后每次展示都读这条链接。链接能打开,图片就显示出来。

这次的不同出现在上传之后。商品服务还会对图片执行一次二次刷新,这次刷新的具体用途记录里没有写,但它会重写这条图片的有效期配置。图片链接不是永久有效的:上传时图片服务给了一段可用期,刷新却用一个更短的有效期覆盖了原配置。等这个更短的时间点过去,链接就打不开了。

业务方在线上看到的结果是:商品的订单详情和订单列表里,商品图片位置变成空白白图。受影响商品的数量、有效期被改成了多长,记录里都没有说明。

本质

一句话:图片链接有期限,上传后的刷新没有沿用原期限,用默认的短期限覆盖了它,已经存进商品数据、又被订单页面读取的旧链接到期后就失效了。

  1. 图片服务为每张上传的图片返回一条带有效期的链接。有效期由图片服务这一侧的配置决定,链接到期后访问会被拒绝。
  2. 上传组件拿到这条链接,商品服务把它当作商品资料的一部分保存;订单详情和订单列表展示商品时,也读这条链接。
  3. 商品服务在图片上传后又做了一次刷新。刷新时既没有沿用原来的有效期,也没有改成长期有效,而是按图片服务的默认有效期重新写了一遍配置。
  4. 默认有效期比上传时的可用期短,于是原本还能用很久的链接,被改成很快就会到期。
  5. 到期之后,图片服务不再返回图片,页面加载失败,用户看到的就是白图。商品记录本身没有坏,坏的是记录里那条链接的可用期。

把“这条链接还能用多久”交给一个会重写配置的刷新动作,又没有在刷新后核对有效期,存量数据里的链接就会比预期更早作废。

记录给出的处理分两步:应急上,后端在订单详情和订单列表接口返回图片时,先用原链接调用图片服务换取最新链接,让页面先能展示;根本上,前端排查上传组件的有效期配置和刷新调用,后端把已存的带有效期的链接统一替换成永久有效的链接。修复上线后的验证情况,记录里没有说明。

下面的 Java 代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 上传商品图片:图片服务返回一条带有效期的链接
String imageUrl = imageClient.upload(file, uploadExpireSeconds);
product.setImageUrl(imageUrl);
productMapper.insert(product);  // 错:把会过期的链接当成长期数据保存

// 商品服务在上传后的二次刷新
public void refreshImage(Long productId, String imageUrl) {
    // 错:刷新只传了链接,有效期回到服务端默认值,原配置被覆盖
    ImageInfo info = imageClient.refresh(imageUrl);
    // 错:默认有效期比上传时短,这里没有比较,直接把更短的到期时间写回
    productMapper.updateImageInfo(productId, info.getUrl(), info.getExpireAt());
}

修复代码示例

// 修复一:上传即申请长期有效的链接,落库的链接不再带到期时间
String imageUrl = imageClient.upload(file, ExpirePolicy.PERMANENT);
product.setImageUrl(imageUrl);
productMapper.insert(product);

// 修复二:刷新时沿用原有效期,并拒绝任何缩短有效期的结果
public void refreshImage(Long productId, String imageUrl, Instant originalExpireAt) {
    ImageInfo info = imageClient.refresh(imageUrl, ExpirePolicy.KEEP_EXISTING);
    if (originalExpireAt != null && info.getExpireAt() != null
        && info.getExpireAt().isBefore(originalExpireAt)) {
        throw new IllegalStateException("刷新后有效期变短,拒绝覆盖");
    }
    productMapper.updateImageInfo(productId, info.getUrl(), info.getExpireAt());
}

ImageInfo 表示图片服务返回的链接及其到期时间;ExpirePolicy 是有效期策略(永久、沿用原值),实际项目里可能叫别的名字。示例只覆盖“刷新不能缩短有效期”这一条,已经存成短效链接的数据,仍要按应急方案逐条换取或批量替换。

下次遇到这些场景要警惕

  • 把外部返回的链接、地址写进业务数据时:先确认这个值有没有有效期、过期后由谁换新,再检查系统里已经存了多少条这样的旧链接,而不是只验证刚创建的那一条。
  • 给上传流程增加刷新、补处理、转存这类步骤时:拿同一张图片比较刷新前后的到期时间,确认新值不早于旧值;如果刷新接口不传有效期就按默认值处理,要显式传策略。
  • 使用图片、文件上传组件时:抓一次“上传、刷新”后的实际链接,直接访问确认能打开,并等过默认有效期后再访问一次,看链接是否仍然可用。
  • 页面出现图片空白时:先直接访问接口返回的图片链接,区分链接失效和页面渲染失败,再比较链接的到期时间与商品创建时间,判断是不是保存时就拿到了短效链接。