
Hello,我是小兔大白糖。 「启动时顺手建一下索引,本地多省事」——副本一多、账号权限一收、CI 空库一跑,这句话就会变成:每个实例抢建同一索引、启动变慢、测试偷偷改库结构、生产 DDL 没有独立变更单。
写成这篇,给要做数据库索引 / DDL 归属心智模型调研的初中级后端同学:文档库与关系库同理——应用进程 ≠ DDL 执行者。
说明:文中 EnsureIndexes / CreateIndex 等是教学名,泛指「应用启动或热路径里创建/确保索引」这类做法;模式 A/B/C 是分析框架,不是某厂 SLA。示例与伪流程均为教学脱敏示意。不写厂商内幕,也不写某仓库删启动建索引的工单流水。同站分工:Mongo 慢查询审计 管怎么量、怎么不说谎;本文钉谁有权改执行计划底座(索引)。分层变更纪律可对照:EKS 升级一次只动一层。
估计阅读时间:9 分钟
目录
为什么现在要关心
硬规则一句话:索引是 DDL(数据定义语言)合同,归迁移 / DBA / infra;应用只假设索引已存在,不在启动热路径里静默补洞。
删掉比喻之后,你仍应能对同事复述这五条:
- 索引是 DDL,不是业务热路径副作用:创建 / 改 / 删索引走迁移或运维通道,不塞进
main/ 应用构造函数。 - 应用只读契约:查询按「索引已存在」来写;缺索引应暴露为可观测故障,而不是启动时偷偷建好。
- 多副本启动 ≠ 安全建索引窗口:并发 CreateIndex、锁等待、重复劳动、权限不足半成功,都很常见(具体锁语义因引擎与版本而异,按「常见故障模式」理解即可)。
- 测试也不该靠应用代码建「生产同款索引」碰巧变绿:需要唯一约束的用例,用夹具迁移,或改断言——别用 CreateIndex 作弊。
- Advisor / 自动建议是候选:落地仍走同一 DDL 通道,并做语义验证(证据怎么诚实,见慢查询审计文)。
心智模型:修路归市政
主比喻:路面是基础设施;出租车司机不在出车时铺沥青。
| 类比 | 含义 |
|---|---|
| 修路归市政 / 路政 | DDL / 索引变更归属迁移、DBA 或 infra |
| 司机只假设路面可用;坑洞报修,不自己浇柏油 | 应用假设索引存在;缺了告警 / fail-fast,不启动自建 |
| 每个司机到岗都浇一遍柏油 | 每个 Pod / 进程启动都跑一遍 EnsureIndexes |
类比局限:修路故事解释谁执行 DDL、为何不在应用启动里做;解释不了该建哪条索引、查询形状怎么选——那是审计与选型另一篇的事。
精确定义:索引是 DDL 合同
把「索引变更」和「业务发版」拆开记账:前者改执行计划底座,后者改业务行为;混在同一启动副作用里,回滚面绑死。
| 概念 | 人话 | 边界 |
|---|---|---|
| DDL | 改结构:表 / 集合形态、索引、约束 | 通常要变更窗、权限、可回滚规划 |
| DML | 改数据:增删改查 | 应用日常热路径 |
| EnsureIndexes 模式 | 启动或初始化时 CreateIndex /「没有就建」 | 单机开发省事;多实例与受限权限下成本高 |
文档型库与关系库在这一点上同构:CreateIndex / CREATE INDEX 都是结构变更,不是普通业务写入。应用账号若长期持有建索引权限,等于把生产 DDL 钥匙挂在每个副本腰上——各托管与自建的角色模型不同,文中「生产应用用户无 createIndex」是安全基线示意,落地以你们权限模型为准。
问题空间:本地绿、现场红
先分清「开发便利」和「多实例 + 权限收紧后的真实合同」。
| 你看到的 | 常见真相 |
|---|---|
| 启动偶发超时 / 锁等待 | 多实例并发建同一索引 |
| 本地绿;只读副本或受限角色红 | 应用账号本就不该有 createIndex |
| 测试依赖「先跑一遍 Ensure」 | 空库语义与生产漂移;唯一约束测靠建索引作弊 |
| 索引变更无审计、难回滚 | DDL 埋进业务发布;出问题分不清是代码还是结构 |
和升级分层一样(见EKS 分层升级):一次搞清「谁改了结构」,比「日历上同一天一起发」更重要。
业界常见模式对照
调研默认选 B(迁移 / infra 显式 DDL);若要防漏迁,用 C 的 check-only——禁止 check 失败后自动 create。
| 模式 | 做法 | 优点 | 代价 |
|---|---|---|---|
| A. 启动 EnsureIndexes | App 启动 CreateIndex /「确保索引」 | 单机开发省事 | 多副本竞态;权限膨胀;DDL 无独立变更单 |
| B. 迁移 / infra 显式 DDL | migrate 工具、IaC、DBA 变更窗 | 可审、可规划回滚、与业务发版解耦 | 本地要跑迁移;空环境要有文档 |
| C. 混合:迁移为主 + 启动校验 | 启动只检查关键则 fail-fast,不创建 | 早发现漏迁 | 仍要运维补洞流程;勿在 check 失败时自动建;索引很多时探测有超时成本,阈值按环境自测 |
模式 A 的隐藏税:每个新副本都可能付一遍「建索引」时间;CI 空库一跑,测试变成隐性迁移器;生产一收权,半成功比全失败更难查。
可复述清单与伪流程
目标态:索引定义有单一事实源;应用启动不建索引;新索引先证据、再变更窗、再依赖查询。
- 清点所有 CreateIndex / Ensure* 入口(启动、脚本、测试 helper)。
- 索引定义迁到迁移目录或 infra 清单;PR 可与业务代码分轨审。
- 应用启动去掉建索引;可选存在性探测 + 明确错误(模式 C)。
- CI:迁移 up 后再跑集成测;禁止测试里 CreateIndex「铺路」。
- 运行账号权限:生产应用用户无 createIndex(示意;以你们安全基线为准)。
- 观测:启动耗时、索引构建锁 / 等待、权限错误率。
- 新索引:先审计证据 → 变更单 → 窗内建 → 再让查询依赖它。
伪流程(教学示意,非某框架 API):
boot(app):
# NOT create_indexes()
optionally assert_required_indexes_exist() # fail-fast or warn
start_serving()
change_index(spec):
review → migrate / infra apply in change window
app assumes new index only after apply succeeds反模式
下面五条,删掉场景名之后仍应能当评审红线念。
- 每个服务自己 Ensure 一套「完整索引」——多服务抢同一库时,竞态与权限面翻倍。
- 测试 CreateIndex 冒充生产就绪——绿的是「测试账号会建索引」,不是「迁移已覆盖」。
- 只读分析账号被授予建索引「图方便」——分析面变成第二条 DDL 通道。
- 把 Advisor 建议直接写进启动代码——未验证候选变成每个 Pod 的副作用。
- 索引与业务逻辑同一 commit,且无独立回滚说明——结构与行为绑死,出事只能整包回滚。
选型结论
- DDL 归迁移 / infra;App 不建索引。
- 要防漏迁:用存在性检查(模式 C),不要用启动自动 create(模式 A)。
- 与慢查询审计分工:那边诚实量形状与请求合计;本文钉谁有权改索引。
- 可带走的复述句:修路归市政;司机报坑,不浇柏油。