localStorage不支持自动过期,需通过存入时附时间戳、读取时校验实现逻辑过期;封装setWithExpiry和getWithExpiry可统一处理有效期、自动清理与兼容旧数据。

localStorage 本身不支持自动过期,但可以通过在存入时附带时间戳、读取时主动校验的方式,实现“逻辑过期”与自动清理。这不是浏览器原生能力,而是靠代码约定和封装来达成的可靠机制。
写入时带上有效期(毫秒级时间戳)
每次 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 解析开销











