### Python SQLAlchemy 分页查询实现 在使用 Python 和 SQLAlchemy 进行数据库操作时，可以通过 `paginate` 或者手动构建分页逻辑来避免一次性加载过多的数据。以下是基于 Flask-SQLAlchemy 的分页实现方式以及如何处理下一页的功能。 #### 使用 Flask-SQLAlchemy 的 `paginate()` 方法 Flask-SQLAlchemy 提供了一个内置的 `paginate()` 方法，可以轻松实现分页功能。该方法接受三个主要参数：当前页码 (`page`)、每页显示的数量 (`per_page`) 以及错误提示标志位 (`error_out`)。如果设置了 `error_out=True` 并且请求的页数超出了范围，则会抛出异常；反之则不会报错并返回空列表[^3]。 下面是一个简单的例子： ```python from flask_sqlalchemy import SQLAlchemy from flask import Flask, request app = Flask(__name__) db = SQLAlchemy(app) class Post(db.Model): id = db.Column(db.Integer, primary_key=True) title = db.Column(db.String(80), nullable=False) @app.route('/posts') def get_posts(): page = request.args.get('page', 1, type=int) # 获取当前页，默认第一页 per_page = 20 # 每页显示20条记录 pagination = Post.query.paginate(page=page, per_page=per_page, error_out=False) posts = pagination.items # 当前页面中的记录信息 total_pages = pagination.pages # 总页数 has_next = pagination.has_next # 是否有下一页 next_page = pagination.next_num if has_next else None # 下一页编号 return { 'data': [{'id': post.id, 'title': post.title} for post in posts], 'pagination': { 'current_page': page, 'total_pages': total_pages, 'has_next': has_next, 'next_page': next_page } } ``` 上述代码实现了以下功能： - 动态接收 URL 参数中的 `page` 值以指定当前页。 - 设置默认每页显示 20 条数据。 - 返回当前页的数据集合 (`items`) 及分页元信息 (如总页数、是否有下一页等)[^3]。 #### 手动实现分页逻辑 如果不依赖于 Flask-SQLAlchemy 的 `paginate()` 方法，也可以通过 SQL 查询语句手动完成分页。这种方式适用于不使用 ORM 工具或者自定义需求较多的情况。 示例如下： ```python from sqlalchemy.orm import sessionmaker from sqlalchemy import create_engine engine = create_engine('sqlite:///example.db') # 替换为实际数据库连接字符串 Session = sessionmaker(bind=engine) session = Session() class Post(Base): # 定义模型类 __tablename__ = 'post' id = Column(Integer, primary_key=True) title = Column(String(80)) def fetch_paginated_data(page, per_page): offset = (page - 1) * per_page # 计算偏移量 query = session.query(Post).order_by(Post.id.desc()) # 构建基础查询 total_count = query.count() # 统计总记录数 items = query.offset(offset).limit(per_page).all() # 应用分页条件 pages = int(total_count / per_page) + (total_count % per_page > 0) # 计算总页数 has_next = True if page < pages else False # 判断是否存在下一页 return { 'data': [{'id': item.id, 'title': item.title} for item in items], 'pagination': { 'current_page': page, 'total_pages': pages, 'has_next': has_next, 'next_page': page + 1 if has_next else None } } result = fetch_paginated_data(page=1, per_page=20) print(result) ``` 此代码片段展示了如何利用原始 SQL 查询语法计算偏移量和限制结果集大小，从而达到分页效果[^4]。 #### 处理下一页功能 无论是采用哪种方式实现分页，在前端界面都需要提供按钮或链接让用户跳转到其他页次。通常情况下，“下一页”的可用状态取决于当前页是否小于最后一页(`has_next`)。当满足这一条件时，应向用户提供前往下一组数据的能力。 以上述两个案例为基础，均提供了关于是否有后续内容的关键字段（即 `has_next`），这使得开发者能够方便地控制 UI 层面的行为表现[^1]。 ---