0

0

如何实现一个带 TTL 的简单 dict 缓存(时间过期)

冰川箭仙

冰川箭仙

发布时间:2026-01-24 18:34:41

|

757人浏览过

|

来源于php中文网

原创

Python自带dict不支持TTL因其纯内存映射,无时间戳、过期检查或自动清理机制;手动维护易致内存泄漏,Timer方案开销大且难管理;推荐懒过期封装方案,读时检查并删除过期项。

如何实现一个带 ttl 的简单 dict 缓存(时间过期)

为什么 Python 自带的 dict 不能直接支持 TTL

因为 dict 是纯内存映射结构,没有内置时间戳、过期检查或后台清理机制。你写入一个键值对后,它就一直存在,哪怕逻辑上该数据已“过期”。手动维护时间戳虽可行,但每次读取都得判断 time.time() > expire_at,且不会自动删除——久而久之会内存泄漏。

threading.Timer 做延迟删除?不推荐

为每个 key 启一个 Timer 看似直观,但实际问题很多:

  • 大量短生命周期 key 会创建海量线程对象,开销大、难管理
  • Timer 一旦启动无法取消(除非用第三方库如 threading.Timer.cancel() 配合状态标记,但易出竞态)
  • 进程退出时未触发的 Timer 不会自动释放,可能卡住程序
  • 无法统一控制最大缓存数或 LRU 淘汰

所以,除非 key 极少且生命周期极长,否则别走这条路。

推荐方案:封装 dict + 时间戳 + 懒过期(lazy expiration)

这是最轻量、可控、无依赖的做法,适合大多数内部工具或脚本场景。核心思路是:写入时记录过期时间,读取时检查是否过期,过期则删掉并返回 None 或抛异常。

示例实现:

AI Web Designer
AI Web Designer

AI网页设计师,快速生成个性化的网站设计

下载
import time

class TTLCache:
    def __init__(self):
        self._cache = {}
        self._times = {}

    def set(self, key, value, ttl_seconds):
        self._cache[key] = value
        self._times[key] = time.time() + ttl_seconds

    def get(self, key, default=None):
        expire_at = self._times.get(key)
        if expire_at is None:
            return default
        if time.time() > expire_at:
            self._cache.pop(key, None)
            self._times.pop(key, None)
            return default
        return self._cache[key]

    def delete(self, key):
        self._cache.pop(key, None)
        self._times.pop(key, None)

关键点:

  • 不依赖外部库,纯标准库,Python 3.6+
  • 读操作触发过期检查(懒过期),避免定时扫描开销
  • 写操作只存两个 dict,无锁(单线程安全;多线程需加 threading.Lock
  • ttl_seconds 为浮点数,支持亚秒级精度(如 0.1

需要线程安全?加一把 threading.Lock 就够了

如果多个线程共用同一个 TTLCache 实例,必须保护共享状态。只需在关键方法加锁,不需要全量同步:

import threading

class ThreadSafeTTLCache:
    def __init__(self):
        self._cache = {}
        self._times = {}
        self._lock = threading.Lock()

    def set(self, key, value, ttl_seconds):
        with self._lock:
            self._cache[key] = value
            self._times[key] = time.time() + ttl_seconds

    def get(self, key, default=None):
        with self._lock:
            expire_at = self._times.get(key)
            if expire_at is None:
                return default
            if time.time() > expire_at:
                self._cache.pop(key, None)
                self._times.pop(key, None)
                return default
            return self._cache[key]

注意:getset 都要锁,但不必锁整个生命周期——比如不要在 get 里长时间持有锁去处理业务逻辑。

真正容易被忽略的是:懒过期机制下,过期 key 可能长期滞留在内存中,直到下次 get 或显式 delete。如果写多读少(比如埋点日志类缓存),得配合定期调用 cleanup() 扫描清理,或者换用 heapq 维护最小堆做主动过期。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

447

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

606

2023.08.10

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

766

2023.08.10

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

377

2025.12.24

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

32

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

30

2026.01.21

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

103

2026.02.06

数据库Delete用法
数据库Delete用法

数据库Delete用法:1、删除单条记录;2、删除多条记录;3、删除所有记录;4、删除特定条件的记录。更多关于数据库Delete的内容,大家可以访问下面的文章。

287

2023.11.13

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号