Symfony 6实体仓库：基于起始ID解决分页数据偏移问题

你目前使用findBy的offset参数实现分页，但当有新数据插入时，传统offset分页会因为数据偏移出现重复或遗漏内容。Doctrine的findBy本身没有直接的startFromID参数，但可以通过**游标分页（基于唯一标识的范围查询）**来替代offset，彻底解决这个问题。

基础实现（基于ID自增主键） #

假设你的订阅实体id是自增主键，且按ID升序加载数据：

首次加载

// 首次加载前5条，明确按ID升序排序
$subscriptions = $userSubscriptionRepo->findBy(
    ['isDeleted' => false, 'disabled' => false],
    ['id' => 'ASC'], // 必须指定排序规则，避免依赖默认排序逻辑
    $this->paginationLimit, // 5
    0
);

下一页加载

获取上一页最后一条数据的ID，然后通过ID范围条件查询下一批数据：

// 获取上一页最后一条的ID
$lastSubscription = end($subscriptions);
$lastId = $lastSubscription->getId();

// 从lastId之后取5条
$subscriptions = $userSubscriptionRepo->findBy(
    [
        'isDeleted' => false,
        'disabled' => false,
        'id' => ['>', $lastId] // 核心：用ID范围替代offset
    ],
    ['id' => 'ASC'],
    $this->paginationLimit // 5
);

进阶实现（多字段排序/非唯一排序字段） #

如果你的排序字段不是唯一的（比如按createdAt倒序，可能有多个订阅在同一时间创建），需要搭配唯一字段（如ID）作为第二排序条件，并用QueryBuilder构建复合条件，避免重复或遗漏：

首次加载（按创建时间倒序）

$qb = $userSubscriptionRepo->createQueryBuilder('s')
    ->where('s.isDeleted = :isDeleted')
    ->andWhere('s.disabled = :disabled')
    ->setParameters([
        'isDeleted' => false,
        'disabled' => false,
    ])
    ->orderBy('s.createdAt', 'DESC')
    ->addOrderBy('s.id', 'DESC') // 用ID作为第二排序，确保唯一性
    ->setMaxResults($this->paginationLimit);

$subscriptions = $qb->getQuery()->getResult();

下一页加载

// 获取上一页最后一条的创建时间和ID
$lastSubscription = end($subscriptions);
$lastCreatedAt = $lastSubscription->getCreatedAt();
$lastId = $lastSubscription->getId();

$qb = $userSubscriptionRepo->createQueryBuilder('s')
    ->where('s.isDeleted = :isDeleted')
    ->andWhere('s.disabled = :disabled')
    // 复合条件：要么创建时间更早，要么同时间但ID更小
    ->andWhere(
        $qb->expr()->orX(
            $qb->expr()->lt('s.createdAt', ':lastCreatedAt'),
            $qb->expr()->andX(
                $qb->expr()->eq('s.createdAt', ':lastCreatedAt'),
                $qb->expr()->lt('s.id', ':lastId')
            )
        )
    )
    ->setParameters([
        'isDeleted' => false,
        'disabled' => false,
        'lastCreatedAt' => $lastCreatedAt,
        'lastId' => $lastId,
    ])
    ->orderBy('s.createdAt', 'DESC')
    ->addOrderBy('s.id', 'DESC')
    ->setMaxResults($this->paginationLimit);

$subscriptions = $qb->getQuery()->getResult();

核心原理 #

游标分页不再依赖固定的偏移量，而是以上一页最后一条数据的唯一标识作为查询起点。无论中间插入多少新数据，都不会影响后续查询的准确性，彻底避免了offset分页的重复/遗漏问题。

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