SQLite LIMIT 两种写法：只是把 OFFSET 换成逗号，为什么取回了另一页
维护分页查询时，把 LIMIT ? OFFSET ? 改成 LIMIT ?, ?，占位符数量仍然是两个，程序也没有报错，却把“取三条、跳过两条”变成“跳过三条、只取两条”。SQLite 支持这两种语法，但它们的参数顺序相反，单纯替换关键字会改变结果。
这种问题容易被页大小等于偏移量的测试漏掉，第一页的零偏移也可能表现得很奇怪。下面用八条编号数据固定排序，选择三和二这两个不同数字，让两个参数的职责从结果中直接看出来。保存为 demo.py 后运行 python demo.py，只使用内存数据库。
同一组参数，在两种语法里角色不同
AI概念示意图：两个调节旋钮互换位置后，同一条数据队列中被选中的区间改变。图片不是运行截图。
import sqlite3
con = sqlite3.connect(":memory:")
try:
con.execute("CREATE TABLE item(id INTEGER PRIMARY KEY)")
con.executemany("INSERT INTO item VALUES (?)", [(i,) for i in range(1, 9)])
def ids(sql, params):
return [row[0] for row in con.execute(sql, params)]
standard = ids("SELECT id FROM item ORDER BY id LIMIT ? OFFSET ?", (3, 2))
comma_wrong = ids("SELECT id FROM item ORDER BY id LIMIT ?, ?", (3, 2))
comma_fixed = ids("SELECT id FROM item ORDER BY id LIMIT ?, ?", (2, 3))
assert standard == comma_fixed == [3, 4, 5]
assert comma_wrong == [4, 5]
print("limit then offset:", standard)
print("same pair with comma:", comma_wrong)
def page(size, offset):
if type(size) is not int or type(offset) is not int:
raise ValueError("size and offset must be integers")
if size < 0 or offset < 0:
raise ValueError("negative pagination values")
return ids("SELECT id FROM item ORDER BY id LIMIT :size OFFSET :offset",
{"size": size, "offset": offset})
assert page(3, 2) == [3, 4, 5]
assert page(3, 99) == []
assert page(0, 0) == []
assert ids("SELECT id FROM item ORDER BY id LIMIT ? OFFSET ?", (-1, 6)) == [7, 8]
assert ids("SELECT id FROM item ORDER BY id LIMIT ? OFFSET ?", (2, -1)) == [1, 2]
for args in [(-1, 0), (2, -1), (True, 0)]:
try:
page(*args)
except ValueError:
pass
else:
raise AssertionError("invalid pagination accepted")
print("pagination checks passed")
finally:
con.close()标准写法得到编号三、四、五，因为先跳过两条，再取三条。逗号写法把同样的参数读为先跳过三条、再取两条，得到四、五。最后将逗号写法的实参对调，才恢复原来的结果。语句都合法，所以这里只检查退出码或是否抛异常，发现不了页面内容已经改变。
参数绑定防止数值被当成 SQL 结构，却不会替程序判断“这个整数是页大小还是偏移量”。代码为生产式入口使用命名占位符 :size 与 :offset，使调用处和查询文字都保留角色名称。真正的排序字段也应来自固定白名单，不能指望给一个占位符绑定列名就完成动态排序。
空页不是总能说明参数无效
偏移量超过表的行数时，返回空列表是正常结果；页大小为零也会得到空列表。示例同时断言两种情况，防止调用层看到空页就自动重试或改查另一页。若产品不允许零条页面，应在入口拒绝零，而不是事后猜测数据库为什么没有给数据。
SQLite 还允许负数 LIMIT 表示不限制返回行数，负数 OFFSET 按零处理。示例仅在八行测试表里验证这两条规则，随后让包装函数明确拒绝负数。否则上游解析失败产生的负一，可能把一个小分页查询变成读取全部结果。数据库接受的范围，通常比业务允许的范围更宽。
稳定顺序是分页的前提条件
每个查询都写 ORDER BY id，且 id 是唯一整数主键。若只按可能重复的名称或时间排序，相等项之间仍可能没有固定顺序，参数即使没有颠倒，也可能出现看似跳动的页边界。真实查询应为主要排序字段补上能够打破并列的唯一字段，并保持所有页面使用同一套顺序。
本例没有并发写入，也没有声称 OFFSET 能保证翻页期间数据快照不变。若两次查询之间插入或删除了前面的记录，后面的偏移位置会变化。这属于分页策略与一致性问题，应另外处理，不能误诊成这里演示的语法参数顺序问题。
让回归测试直接描述想拿到的记录
对分页接口，应保留首条、尾条、返回数量，以及页大小与偏移不相等的样本。入口校验采用 type(value) is int，故意排除 Python 中可以表现为整数的布尔值；这种严格程度是本例的接口约定，若项目接受其他整型对象，应显式调整验证方式。
调试时将 SQL 模板和参数名称分别记录，并用同一份小数据重放。不要为方便把外部字符串拼回语句。新代码优先保留 LIMIT 加 OFFSET 的写法，能让阅读顺序贴合“取多少、从哪里开始”，减少将旧方言查询迁入 SQLite 时的误解。
资料核对日期：2026年10月2日（北京时间）。代码在 CPython 3.12.14 中独立运行；SQLite 示例使用其连接的 SQLite 3.53.1。
