如何优雅的避免cloudinary云图片加载失败?

前言

我在使用cloudinary(一个云图像/视频平台)的时候发现一个潜在问题:有时候获取图片地址的时候初次获取是无法正确获取到的,必须刷新一次或多次才能正确获取到图片,但是浏览器只会加载一次图片,这就会导致图片即使存在也无法正确加载从而被备用图片替换。

补充一下我使用cloudinary的方式:通过cloudinary提供的上传组件实现图片上传,在图片上传的同时记录下当前上传图片的云地址并存储到数据库,每次使用云图片的时候只需要调用这个地址。

正文

下面是个简单的例子,主要关注src部分,user?.image就是数据库中存储的云图片地址,当我们没有拿到的时候就用"/images/person.jpg"替换。

typescript 复制代码
<img
    ref={imageRef}
    src={user?.image || "/images/person.jpg"}
    alt="image"
    className="w-8 h-8 rounded-full mt-[2px]"
/>

那么如何解决前言中的问题呢?

typescript 复制代码
const imageRef = useRef<HTMLImageElement | null>(null);

const handleImageError = (event: React.SyntheticEvent<HTMLImageElement, Event>) => {
  const imgElement = event.currentTarget;
  imgElement.src = user?.image;
};

return (
  <img
    ref={imageRef}
    src={user?.image || "/images/person.jpg"}
    alt="image"
    className="w-8 h-8 rounded-full mt-[2px]"
    onError={handleImageError}
  />
);

这段代码中我们给onError绑定了handleImageError事件,作用就是当user?.image图片获取错误时都会触发onError事件从而多次加载图片,这样我们就可以避免初次加载无法拿到图片的情况。

这样就结束了吗?当然没有,当user?.image一直无法正确获取就会造成无限循环,所以我们要在其基础上进行循环处理:

typescript 复制代码
const imageRef = useRef<HTMLImageElement | null>(null);
const timerRef = useRef<NodeJS.Timeout | null>(null);  // 用于存储定时器

const handleImageError = (event: React.SyntheticEvent<HTMLImageElement, Event>) => {
  const imgElement = event.currentTarget;
  
  // 如果定时器已存在,说明在2s等待时间内
  if (timerRef.current) {
    // 继续尝试原来的操作
    imgElement.src = user?.image;
    return;
  }

  // 设置2s定时器
  timerRef.current = setTimeout(() => {
    // 2s后直接使用备用地址
    if (imgElement) {
      imgElement.src = "/images/person.jpg";
    }
    // 清除定时器引用
    timerRef.current = null;
  }, 2000);

  // 首次错误时也执行原操作
  imgElement.src = user?.image;
};

// 组件卸载时清理定时器
useEffect(() => {
  return () => {
    if (timerRef.current) {
      clearTimeout(timerRef.current);
    }
  };
}, []);

return (
  <img
    ref={imageRef}
    src={user?.image || "/images/person.jpg"}
    alt="image"
    className="w-8 h-8 rounded-full mt-[2px]"
    onError={handleImageError}
  />
);

通过添加定时器,我们可以设定强制赋值备用图片地址的时间,在这里我设置的是2s可以根据各自情况修改。这样设置后,会给模板图片2s的加载时间,2s后打断。

相关推荐
十有八七41 分钟前
手搓 Agent(一):先有大脑——大模型只会做一件事
前端·人工智能·后端
锋行天下43 分钟前
「踩坑实录」给 LangGraph Agent 接两个 FastMCP,我被 langchain 偷偷改了工具名
前端·人工智能·后端
跳跳的小星星1 小时前
自研组件】Vue2 + ElementUI 通用列表页封装 wkjp-list-page,一套配置搞定搜索、动态表格、分页、增删改
前端
tryCbest1 小时前
Vue3—— 第 18 篇:Vue 2 到 Vue 3 迁移指南——升级避坑全记录
前端·vue.js
保利威视频SaaS小张1 小时前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv
bysking2 小时前
GitHub Actions 快速入门+场景实践案例
前端·后端·github
广州华水科技2 小时前
单北斗GNSS变形监测系统在大坝安全维护中的重要性
前端
anyup2 小时前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app
涛涛ing3 小时前
别拿 Chrome 跑通了就提测:把这段 AI 写的代码发到 Safari 上,我差点丢了工作
前端
墨林陌3 小时前
用 AI 给娃做了一个识物游戏:一份 2.3MB 的单文件 HTML,126 张卡片、三种玩法,手机平板打开就能玩
前端