Linux timerfd 是 Linux 内核提供的一种基于文件描述符的定时器接口，它允许程序通过读取文件描述符来获取定时器到期事件，是构建高精度、可扩展事件驱动程序的核心组件，尤其适合与 epoll 配合使用。
想象你正在编写一个高并发网络服务器,需要同时处理数千个连接和多种定时任务，比如心跳维持、会话超时、定期数据统计，传统的定时器方式，如 alarm 或 setitimer，会向进程发送信号，打断正常的系统调用，迫使你编写复杂的信号处理函数，稍有不慎就会引入难以调试的竞争问题，而 timerfd 将定时器抽象为文件描述符，你可以像处理普通 socket 一样，用 epoll 统一监控它们，这种设计让定时事件完美融入异步事件循环，代码更安全，性能更稳定。
![[Linux C] setitimer函数实现定时器功能](https://i0.hdslb.com/bfs/archive/4cd7831d0e152863bb3763f68df80814cb8e0460.jpg)
什么是 Linux timerfd
从定时器到文件描述符
timerfd 是 Linux 2.6.25 引入的定时器机制，它通过 timerfd_create 创建文件描述符，用 timerfd_settime 设置定时参数，当定时器到期时，文件描述符变为可读，读取它得到一个 uint64_t 值，表示自上次读取以来到期的次数，这种设计将定时事件与信号完全解耦，符合现代事件驱动编程的核心理念。
为什么选择 timerfd
- 信号无关：不再需要处理 SIGALRM，避免了信号处理函数的限制（如不能调用 pthread 函数、不能处理某些锁）。
- 多路复用友好：支持 select、poll、epoll，可同时监控多个定时器，性能开销极低。
- 高精度与灵活配置：支持纳秒级设置，可一次性或重复触发，且支持单调时钟，不受系统时间调整干扰。
- 资源安全：文件描述符式生命周期管理，关闭即取消定时器，不会残留。
Linux timerfd 用法详解
创建与配置
创建 timerfd 只需三步：
- 调用
timerfd_create：指定 clockid 和 flags，clockid 推荐CLOCK_MONOTONIC，避免因系统时间回拨导致定时错误，flags 建议同时设置TFD_NONBLOCK和TFD_CLOEXEC
，确保非阻塞和安全的文件描述符继承。
- 设置定时时间：通过
timerfd_settime设置itimerspec，该结构体包含it_value（初始延迟）和it_interval（间隔时间），若it_interval为 0，则定时器只触发一次；否则重复触发。 - 读取到期事件：使用
read(fd, &exp, sizeof(uint64_t))读取到期次数。exp是一个 uint64_t，表示定时器到期的次数，如果定时器在两次读取之间多次到期，该值会累加，因此不会丢失事件。
参数注意事项
- clockid 选择：
CLOCK_REALTIME受系统时间调整影响，可能导致定时器突然提前或延迟。CLOCK_MONOTONIC则不受影响，适合大多数场景，需要绝对时间时可使用CLOCK_BOOTTIME（包含系统挂起时间）。 - 非阻塞标志：在事件循环中，务必设置
TFD_NONBLOCK，这样即使没有事件，read 也不会阻塞，配合 epoll 边缘触发时，这是必须的。 - 绝对时间：
timerfd_settime的 flags 参数可设为TFD_TIMER_ABSTIME，表示it_value为绝对时间，适用于需要精确到某个时刻的任务。
读取与事件处理
每次 read 必须完整读取 8 字节，否则后续 read 可能返回 EINVAL，在边缘触发模式下，你需要循环读取直到返回 EAGAIN，消耗所有累积的到期事件。
uint64_t exp;
while (read(tfd, &exp, sizeof(exp)) > 0) {
// 处理此次到期事件（exp 可能大于 1）
}
如果使用水平触发,epoll 会持续通知可读，直到你读取，因此需要及时处理，避免重复触发。
使用场景：timerfd 与 epoll 结合实例
统一事件循环模型
在一个典型的 epoll 事件循环中，你可以将多个 timerfd 描述符注册到同一个 epoll 实例，一个用于心跳检测，一个用于定时统计，另一个用于延迟清理，当 epoll_wait 返回时，检查哪些 fd 可读，并分派到对应的处理函数，这避免了为每个定时器创建线程，且代码结构清晰、易于扩展。
实际示例：心跳超时检测
假设一个聊天服务器,需要每 30 秒检查一次客户端活跃状态，你创建一个 timerfd，设置初始延迟 30 秒、间隔 30 秒，将其加入 epoll，在事件循环中，每次该 timerfd 可读时，遍历客户端列表，关闭超时连接，这种实现比使用信号或者线程池简单得多，而且性能更高。
多定时器管理
对于需要同时管理多个定时任务的场景,比如一个定时器用于日志刷新（每 5 秒），另一个用于缓存清理（每 60 秒），另一个用于健康检查（每 10 秒），你可以创建三个 timerfd，全部注册到 epoll，业内专家指出，在超过 100 个定时器的情况下，timerfd 组合 epoll 的性能远优于传统基于信号或轮询的方案，且代码逻辑更加可控。
Linux timerfd 与 setitimer 对比
| 特性 | timerfd | setitimer |
|---|---|---|
| 事件通知机制 | 文件描述符可读 | 信号 SIGALRM |
| 精度 | 纳秒级（理论） | 微秒级 |
| 同时支持定时器数量 | 无限制（每个文件描述符一个） | 每个进程仅 1 个（ITIMER_REAL） |
| 与多路复用集成 | 原生支持 epoll/poll/select | 无法直接集成，需额外处理 |
| 可移植性 | Linux 专有 | POSIX 标准，跨平台 |
| 安全性 | 无信号问题，可安全用于所有线程 | 信号处理需谨慎，存在 reentrant 风险 |
| 使用复杂度 | 需了解文件描述符操作 | 简单但功能有限 |
行业共识认为,在 Linux 平台上，timerfd 在功能、性能和易用性上全面优于 setitimer，除非你需要代码跨平台运行，否则应优先选择 timerfd。
Linux timerfd 编程常见错误
未读取完整 8 字节
有些开发者会在 read 时传入错误的缓冲区大小，或者只读取部分字节，这会导致后续 read 返回 EINVAL
，因为文件描述符状态被破坏，始终使用 read(fd, &exp, sizeof(uint64_t)) 来读取。
时钟源选择错误
使用 CLOCK_REALTIME 作为时钟源，当系统管理员手动调整时间或通过 NTP 回拨时，你的定时器可能突然触发或延迟，如果不需要绝对时间，请使用 CLOCK_MONOTONIC。
阻塞与非阻塞混淆
在事件循环中,如果不设置 TFD_NONBLOCK，当定时器未到期时，read 会阻塞整个线程，破坏事件循环，始终将 timerfd 设置为非阻塞，并在 epoll 事件驱动下读取。
忽略边缘触发特性
使用边缘触发时,epoll 只在可读状态变化时通知一次，如果你没有在通知后读取所有数据，后续的到期事件将不会触发新通知，导致事件丢失，务必循环读取直到 EAGAIN。
Linux timerfd 常见问题解答
Q1: timerfd 在多线程环境下使用安全吗？
A: 安全，timerfd 文件描述符是线程安全的，但建议在单个线程中创建和读取，以避免竞争，如果需要在不同线程间传递，可以配合事件队列或管道，最简单的方式是让创建定时器的线程同时负责事件循环。
Q2: timerfd 的精度在实际应用中能达到多高？
A: 多数情况下，timerfd 的精度可以达到微秒级别，这取决于内核配置和硬件，对于毫秒级精度的应用，如网络超时和心跳检测，完全足够，如果需要纳秒级定时，需要考虑内核调度延迟和硬件限制，但 timerfd 提供了纳秒级设置接口，底层支持高分辨率定时器（HRT）。
Q3: 如何避免 timerfd 事件丢失？
A: 使用非阻塞 fd 和边缘触发，在可读事件发生后循环读取 uint64_t 直到返回 EAGAIN，确保所有累积到期次数都被消耗，确保你的处理逻辑足够快，避免长时间阻塞其他事件，如果使用水平触发，虽然不会丢失事件，但可能会重复触发，需要注意处理重复。
timerfd 是 Linux 异步编程中不可或缺的定时器工具，它与 epoll 的配合，为构建高性能、可扩展的网络服务提供了坚实可靠的基础。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/linux-timerfd%e5%ae%9a%e6%97%b6%e5%99%a8%e7%9a%84%e5%b7%a5%e4%bd%9c%e5%8e%9f%e7%90%86%e6%98%af%e4%bb%80%e4%b9%88%ef%bc%9f%ef%bc%8c%e5%a6%82%e4%bd%95%e4%bd%bf%e7%94%a8/
