如何使带秒级DateTime参数的Doctrine结果缓存生效？

1. 将DateTime参数向下取整到更大时间粒度 #

这是最直接的解决方案，把每秒变化的时间参数统一到分钟、小时等更大的粒度，让相同时间区间的查询复用缓存。

比如将当前时间取整到分钟（秒数置0）：

$now = new \DateTime();
// 取整至当前分钟，消除秒级变化
$roundedNow = (clone $now)->setTime($now->format('H'), $now->format('i'), 0);

$query = $entityManager->createQuery('SELECT u FROM User u WHERE u.createdAt < :now');
$query->setParameter('now', $roundedNow);
$query->enableResultCache(3600); // 设置1小时缓存有效期

根据业务对时间精度的要求，还可以取整到小时、日期等，平衡缓存命中率和查询准确性。

2. 自定义缓存键生成逻辑 #

Doctrine支持手动指定缓存键，或通过自定义QueryCacheProfile控制缓存键的生成规则，避免秒级参数破坏缓存复用。

方式一：手动生成缓存键 #

先将DateTime参数处理为粒度更大的标识，再拼接成唯一缓存键：

$now = new \DateTime();
// 按小时粒度生成缓存键的唯一标识部分
$cacheKeySegment = $now->format('YmdH');
$customCacheKey = 'recent_users_' . $cacheKeySegment;

$query = $entityManager->createQuery('SELECT u FROM User u WHERE u.createdAt >= :start AND u.createdAt < :now');
$query->setParameters([
    'start' => (clone $now)->modify('-1 hour'),
    'now' => $now
]);
$query->enableResultCache(3600, $customCacheKey);

方式二：自定义QueryCacheProfile #

通过自定义缓存键生成回调，自动处理DateTime参数后生成缓存键：

use Doctrine\ORM\Query\QueryCacheProfile;

$cacheProfile = new QueryCacheProfile(
    3600, // 缓存有效期
    null,
    function ($query) {
        $params = $query->getParameters();
        // 遍历参数，将DateTime类型参数取整到分钟
        foreach ($params as $key => $param) {
            $value = $param->getValue();
            if ($value instanceof \DateTimeInterface) {
                $roundedValue = (clone $value)->setTime(
                    $value->format('H'),
                    $value->format('i'),
                    0
                );
                $params[$key] = $roundedValue;
            }
        }
        // 基于处理后的DQL和参数生成缓存键
        return md5($query->getDQL() . serialize($params));
    }
);

$query->setQueryCacheProfile($cacheProfile);

3. 注意事项 #

• 时间粒度的选择必须匹配业务需求，不能为了缓存牺牲查询结果的准确性；
• 如果查询的是时间范围（如最近N分钟），需同时对起始时间和结束时间做取整处理，确保时间区间的统一性；
• 缓存有效期要和时间粒度匹配，比如按分钟取整的参数，缓存有效期至少设置为1分钟以上，避免缓存提前失效。

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