PHP PDO分页加载数据异常求助：仅显6条记录但分页多页

嘿，我完全懂你现在的困扰——明明页面只加载了6条度假套餐记录，但分页控件却显示有好几页，作为第一次用PDO的开发者，这种问题确实容易踩坑。我来帮你一步步排查和解决这个问题：

1. 总记录数计算错误（最常见） #

分页的核心逻辑依赖两个查询：一个查当前页的列表数据，另一个查符合条件的总记录数。如果总记录数的SQL写错了，分页控件就会显示错误的页数。

常见错误场景： #

• 总条数查询加了LIMIT：比如你不小心写成了SELECT COUNT(*) FROM vacation_packages LIMIT 6，那总记录数永远会返回6，但如果数据库里实际只有6条，却因为其他错误导致总条数被算出更大的值（比如条件不一致），就会出现分页显示多页的情况。
• 总条数查询的WHERE条件和列表查询不一致：比如列表查询筛选了status = 'active'的套餐，但总条数查询没加这个条件，导致算出的总记录数远大于实际显示的有效数据，分页自然就多了。

排查方法： #

在代码里打印出总记录数和总页数的值，看看是否和数据库实际数据匹配：

// 在计算完总记录数后加这行代码
var_dump($totalRecords, $totalPages); exit;

如果数值不对，立刻检查总条数的SQL语句，确保它和列表查询的筛选条件完全一致。

2. 分页参数计算错误 #

每页显示条数（$perPage）、当前页（$page）、偏移量（$offset）的计算逻辑出错，也会导致分页显示异常。

正确的计算逻辑示例： #

$perPage = 6; // 每页显示6条
$page = isset($_GET['page']) ? (int)$_GET['page'] : 1; // 默认第1页
$offset = ($page - 1) * $perPage; // 偏移量从0开始计算

// 总页数必须用ceil向上取整
$totalPages = ceil($totalRecords / $perPage);

如果$page的默认值设成了0，或者偏移量计算错误，可能会导致查询结果异常，同时分页控件的页数计算也会出错。

3. PDO查询的细节问题 #

作为PDO新手，这些细节容易忽略：

• 绑定LIMIT参数时必须指定PDO::PARAM_INT类型，否则PDO可能会把数字当成字符串处理，导致查询结果异常：

$stmt->bindParam(':offset', $offset, PDO::PARAM_INT);
$stmt->bindParam(':perPage', $perPage, PDO::PARAM_INT);

• 开启PDO的错误提示，方便排查SQL执行错误：

// 在PDO连接后添加这行代码
$this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

这样如果SQL有语法错误或者执行失败，会直接抛出异常，帮你快速定位问题。

你可以参考这个标准的分页实现，对比自己的代码找差异：

class INDEX {
    private $pdo;

    public function __construct() {
        // 初始化PDO连接
        $this->pdo = new PDO('mysql:host=localhost;dbname=your_db;charset=utf8mb4', 'username', 'password');
        $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    }

    // 获取度假套餐列表及分页数据
    public function getVacationPackages($page = 1, $perPage = 6) {
        // 1. 查询符合条件的总记录数（条件必须和列表查询一致）
        $countStmt = $this->pdo->prepare("SELECT COUNT(*) FROM vacation_packages WHERE status = 'active'");
        $countStmt->execute();
        $totalRecords = $countStmt->fetchColumn();
        $totalPages = ceil($totalRecords / $perPage);

        // 确保当前页在有效范围内（防止恶意传参）
        $page = max(1, min($page, $totalPages));
        $offset = ($page - 1) * $perPage;

        // 2. 查询当前页的套餐数据
        $listStmt = $this->pdo->prepare("SELECT * FROM vacation_packages WHERE status = 'active' LIMIT :offset, :perPage");
        $listStmt->bindParam(':offset', $offset, PDO::PARAM_INT);
        $listStmt->bindParam(':perPage', $perPage, PDO::PARAM_INT);
        $listStmt->execute();
        $packages = $listStmt->fetchAll(PDO::FETCH_ASSOC);

        return [
            'packages' => $packages,
            'currentPage' => $page,
            'totalPages' => $totalPages,
            'totalRecords' => $totalRecords
        ];
    }
}

如果按照上面的步骤排查后还是解决不了问题，可以把你index.class里完整的分页相关代码贴出来，我帮你精准定位问题~

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