讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

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

雨辰君_4093

雨辰君_4093

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

|

797人浏览过

|

来源于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 或抛异常。

示例实现:

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载
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]

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

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

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

6907

2023.07.18

堆和栈区别
堆和栈区别

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

2848

2023.08.10

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

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

4798

2023.08.10

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

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

1349

2025.12.24

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

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

443

2026.01.21

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

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

599

2026.01.21

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

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

449

2026.02.06

C++多线程并发控制与线程安全设计实践
C++多线程并发控制与线程安全设计实践

本专题围绕 C++ 在高性能系统开发中的并发控制技术展开,系统讲解多线程编程模型与线程安全设计方法。内容包括互斥锁、读写锁、条件变量、原子操作以及线程池实现机制,同时结合实际案例分析并发竞争、死锁避免与性能优化策略。通过实践讲解,帮助开发者掌握构建稳定高效并发系统的关键技术。

273

2026.03.16

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

80

2026.11.06

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn