Cloudflare D1 查询优化:用 EXPLAIN 找出真正昂贵的扫描

D1 的查询优化不能只看接口返回了多少行:Cloudflare 的文档指出,计费与查询读取、写入的行数有关。返回 10 条记录的查询,可能为了排序或过滤扫描了大量数据。

先看执行计划

文章表常用查询是按发布状态过滤、按时间倒序:SELECT slug,title FROM posts WHERE draft=0 ORDER BY created_at DESC LIMIT 20。可以评估复合索引 (draft, created_at DESC),再使用 EXPLAIN QUERY PLAN 和查询结果中的行读取指标确认是否减少扫描。不要仅凭“建了索引”就假设有效;索引也需要存储和写入维护成本。

搜索 LIKE '%关键词%' 通常不能靠普通 B-tree 前缀索引加速。小博客全表扫描可以接受,但随着文章和搜索流量增加,应考虑 FTS5 等方案,并实测中文分词或 trigram 的行为、索引成本与 D1 当前支持情况。

分页与一致性

深页 OFFSET 仍可能扫描并跳过大量行。可考虑基于 (created_at, slug) 的游标分页,用稳定且唯一的排序键处理同一时间的多篇文章。若启用读副本,要理解副本延迟;需要“刚发布立即看到”的操作可考虑 D1 Sessions API 的一致性语义,具体以官方文档为准。

优化流程:先记录 P95、rows_read 和真实查询,再针对热查询加索引;在预发布环境对比执行计划与写入成本;上线后监控,而不是一次性给每一列加索引。

参考:D1 索引最佳实践;D1 读副本。