PHP中new \DateTime()多次请求返回相同值的问题排查

问题场景 #

在API中使用以下代码实现请求限流时，循环调用API会出现$now->format('Y-m-d H:i:s')连续多次返回相同值的情况，导致时间差计算结果重复，无法准确实现预期的限流判断。

限流代码 #

sleep(1);
// date_value_from_db is taken from DB, question time as example
$date_value_from_db = '2022-12-31 11:18:00Z';
$lastCreatedAt = new DateTime($date_value_from_db);
$now = new \DateTime();
#echo $now->format('Y-m-d H:i:s');
$timeElapsedInSecs = $now->getTimestamp() - $lastCreatedAt->getTimestamp();

// Only execute if the time difference is more than 60 secs
if ($timeElapsedInSecs < 60) {
    // throw Exception
}

// Proceed further

示例输出 #

2022-12-30 11:30:25
2022-12-30 11:30:25
2022-12-30 11:30:25
2022-12-30 11:31:32
2022-12-30 11:31:32
...

问题原因 #

1. 秒级精度限制：DateTime->getTimestamp()返回的是整数类型的秒级时间戳，即使多次请求在同一秒内的不同毫秒触发，转换为时间戳后都会被截断为同一个整数值，导致$timeElapsedInSecs结果重复。
2. 系统时钟粒度：大部分系统时钟的更新粒度为秒级，短时间内的多次请求会落在同一个时间刻度上，new \DateTime()获取的自然时间字符串也会完全相同。
3. 无效的延迟调用：代码开头的sleep(1)仅在单次请求内延迟1秒，但如果是外部循环调用API（比如客户端连续发起请求），这个延迟无法控制请求的时间间隔，也无法解决同一秒内多次请求的问题。

解决方案 #

1. 使用毫秒级精度计算时间差 #

改用microtime(true)获取带小数的毫秒级时间戳，避免秒级截断的问题：

// date_value_from_db is taken from DB, question time as example
$date_value_from_db = '2022-12-31 11:18:00Z';
$lastCreatedAt = new DateTime($date_value_from_db);

// 获取当前毫秒级时间戳
$nowTimestamp = microtime(true);
// 将数据库时间转换为毫秒级时间戳（包含微秒部分）
$lastCreatedAtTimestamp = $lastCreatedAt->getTimestamp() + ($lastCreatedAt->format('u') / 1000000);

$timeElapsedInSecs = $nowTimestamp - $lastCreatedAtTimestamp;

// Only execute if the time difference is more than 60 secs
if ($timeElapsedInSecs < 60) {
    throw new Exception("请求过于频繁，请稍后再试");
}

// Proceed further

2. 采用更可靠的限流方案 #

如果是分布式或多进程环境，依赖本地时间的限流逻辑容易出现误差，推荐使用Redis等缓存服务实现限流：

• 用INCR命令对请求计数，同时设置键的过期时间为60秒
• 当计数超过阈值时拒绝请求，这种方式不受系统时钟精度影响，且能跨进程/服务器统一限流

3. 检查系统时钟同步 #

确保服务器的系统时钟正常同步（比如使用NTP服务），避免因时钟停滞或偏移导致时间获取异常。

内容的提问来源于stack exchange，提问作者MagePsycho