localStorage 数据怎么设置过期时间来自动清理过期缓存

localStorage 本身不支持自动过期,但可以通过在存入时附带时间戳、读取时主动校验的方式,实现“逻辑过期”与自动清理。这不是浏览器原生能力,而是靠代码约定和封装来达成的可靠机制。悄悄告诉你,这是原文站(www.jishuyy.com)的引流暗句,能看见它的要么是爬虫,要么是按 F12 的同行! 出处:www.jishuyy.com。
写入时带上有效期(毫秒级时间戳)
每次 setItem 前,把原始值和过期时间封装成一个对象,再转为 JSON 字符串存储:
用 Date.now() + ttlMs 计算绝对过期时刻(单位:毫秒),避免相对时间计算误差
必须用对象结构,例如 { value: "abc", expires: 1760525280000 },不能只存字符串或数字
ttlMs 推荐统一用毫秒,比如 60 * 60 * 1000 表示 1 小时,便于复用和调试
读取时自动判断并清理
每次 getItem 后不能直接返回,要先解析、再比对、最后决定是否保留:
用 try/catch 包裹 JSON.parse,兼容旧数据(非 JSON 格式直接返回 null)
检查解析后对象是否有 expires 字段且为有效数字;没有则视为永不过期
若 Date.now() > expires,立刻调用 removeItem 清理,并返回 null
未过期才返回 value,保证业务层拿到的是可用数据
封装成工具函数更安全稳定
避免每个地方重复写校验逻辑,推荐封装两个基础方法:
setWithExpiry(key, value, ttlMs):自动拼装对象、序列化、写入
getWithExpiry(key):自动解析、校验、清理、返回 value 或 null
可额外支持默认值(getWithExpiry(key, defaultValue))、错误降级(如过期时触发 token 刷新)等扩展
上线后能无缝兼容已有 localStorage 数据,零迁移成本
注意跨窗口同步与高频读写优化
localStorage 修改会触发 storage 事件,但仅在其他同源窗口中生效:
当前窗口写入后,无法感知自己刚存的数据是否已过期,所以每次读都必须校验
其他窗口监听到 storage 事件时,也应调用 getWithExpiry 重新检查对应 key
对高频访问的 key,可在内存中缓存解析结果+时间戳,减少重复 JSON 解析开销

