设置1000毫秒间隔时timerfd定时器未运行的问题排查

核心问题1：纳秒值超出合法范围 #

struct timespec的tv_nsec成员要求取值必须在0到999,999,999之间（即小于1秒）。当设置1000毫秒时，mNanoseconds = 1000 * 1000000 = 1000000000，这个值刚好等于1秒，超出了tv_nsec的合法范围，直接导致定时器参数无效。

对于大于等于1000毫秒的间隔，必须把毫秒数拆分为秒和纳秒两部分：

• 秒数 = 毫秒数 / 1000
• 剩余纳秒数 = (毫秒数 % 1000) * 1000000

核心问题2：it_value的赋值逻辑完全错误 #

你当前代码里的这行是致命错误：

itime.it_value.tv_sec = itime.it_interval.tv_nsec;

1. 你使用了TFD_TIMER_ABSTIME标志，意味着it_value需要设置为绝对时间戳（从CLOCK_REALTIME纪元开始的秒+纳秒），但你直接把间隔的纳秒数值塞给了tv_sec，相当于把首次触发时间设为10亿秒之后，永远不会触发。
2. 就算不使用绝对时间，it_value也应该设置为首次触发的延迟时间，和it_interval保持一致即可，而非错误复用纳秒值到秒字段。

修复后的关键代码示例 #

void Timer::startIntervalTimer()
{    
    struct itimerspec itime;
    int count = 0;

    // 拆分毫秒为合法的秒+纳秒
    time_t interval_sec = mMilliseconds / 1000;
    long interval_nsec = (mMilliseconds % 1000) * 1000000;

    // 设置定时器间隔：每次触发的时间差
    itime.it_interval.tv_sec = interval_sec;
    itime.it_interval.tv_nsec = interval_nsec;

    // 设置首次触发时间：使用相对时间，和间隔保持一致
    itime.it_value.tv_sec = interval_sec;
    itime.it_value.tv_nsec = interval_nsec;

    int fd = timerfd_create(CLOCK_REALTIME, 0 );
    // 去掉TFD_TIMER_ABSTIME，使用相对时间模式更符合你的需求
    if (timerfd_settime(fd, 0, &itime, NULL) == -1) {
        perror("timerfd_settime failed");
        return;
    }

    while(count != 10)
    {
        uint64_t exp;
        int n = read(fd, &exp, sizeof(exp));
        if (n == -1) {
            perror("read timerfd failed");
            break;
        }

        // 用lock_guard自动管理锁，避免死锁
        std::lock_guard<std::mutex> lock(g_thread_mutex);
        std::string t = getTime();
        std::cout << t << "  fd = " << fd << "  count # " << count << std::endl;

        count++;
    }  
    close(fd);
}

额外优化建议 #

• 用std::lock_guard代替手动调用lock()和unlock()，避免因异常或忘记解锁导致死锁。
• 调用timerfd_settime和read后检查返回值，用perror()打印错误信息，方便调试。
• 如果确实需要绝对时间触发，需先获取当前系统时间，再叠加间隔时间赋值给it_value。

内容的提问来源于stack exchange，提问作者Mr.Longbottom