gorm 的 explain() 方法受限于数据库支持、复杂查询失效及返回格式单一，需手动拼接 explain (analyze, buffers)；应透传路由信息（如 c.fullpath()）至 sql 日志，核对字段映射与索引一致性，并在批量导出时绕过 gorm 直连数据库执行真实计划分析。
Explain 不能直接在 GORM 中调用，得绕开链式 API 手动拼 SQL
GORM 的 Explain() 方法（v1.23+）只支持 MySQL 和 PostgreSQL，且仅对最终生成的 SQL 生效，不适用于带 Preload 或嵌套 Joins 的复杂查询——它会把整个 JOIN 链当做一个语句解释，但实际执行时优化器可能因字段缺失、索引未命中而走错路径。更关键的是，Explain() 返回的是字符串，没法直接和 EXPLAIN (ANALYZE, BUFFERS) 这类 PostgreSQL 增强模式对接。
实操建议：
- 用
db.Session(&gorm.Session{DryRun: true}).First(&u)提前拿到原始 SQL，再手动拼接EXPLAIN (ANALYZE, BUFFERS)发给数据库 - PostgreSQL 场景下，务必加
ANALYZE：它会真实执行并返回实际耗时、IO 次数、是否触发 seq scan，比纯计划更可信 - MySQL 用户注意：
EXPLAIN FORMAT=JSON比传统格式更能暴露“Using temporary”“Using filesort”这类隐性开销点 - 别在事务里跑
EXPLAIN ANALYZE，某些驱动（如 pgx）会报ERROR: cannot explain a transaction block
路由层埋点要能关联到具体 SQL，否则 Explan 结果等于废纸
很多团队在中间件里记了请求耗时，但没把 ctx.Value("trace_id") 或 c.Param("id") 透传进数据库日志，导致查到一条 2s 的慢查询，却不知道它来自哪个接口、哪个用户 ID、甚至哪个路由分组。Gin 的 c.FullPath() 是唯一稳定标识路由模板的字段（比如 /api/v1/users/:id/orders），必须和 SQL 日志绑定。
实操建议：
- 在 GORM 的
logger.Interface实现中，从 Gin 的*gin.Context取c.FullPath()和c.GetHeader("X-Request-ID")，拼进每条 SQL 日志前缀 - 避免用
c.Request.URL.Path，它含实际参数（如/api/v1/users/123/orders），聚合分析时无法归类 - 如果用了路由组（如
v1 := r.Group("/api/v1")），可在中间件里把v1的 prefix 存进 context，后续统一注入日志
Explain 显示 “Seq Scan” 却没建索引？先确认 GORM 是否偷偷改了字段名
GORM 默认把结构体字段 CreatedAt 映射为数据库列 created_at，但如果模型里写了 gorm:"column:ctime"，而你按惯例在 created_at 上建了索引，Explain 就永远显示 “Seq Scan”。更隐蔽的是软删除字段：DeletedAt 默认映射为 deleted_at，但若表里实际是 is_deleted bool 类型，GORM 的 Unscoped() 查询就根本不会走索引。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
实操建议：
- 用
db.Migrator().CurrentDatabase() == "postgres"区分环境，在启动时打印所有模型的TableName()和字段映射，核对 DDL - PostgreSQL 下执行
\d+ table_name看真实列名和索引，别信迁移脚本里的注释 - 对
WHERE条件中出现的字段，用db.Debug().Where("user_id = ?", id).First(&o)触发日志，确认生成的 SQL 列名是否和索引一致
批量导出场景下 Explain 失效，得切到 pgx.Batch 或 COPY 协议
FindInBatches 在百万级数据导出时，Explain 显示的执行计划和真实行为偏差极大：它按主键分页，但每次批次仍是一次独立 SELECT，而 PostgreSQL 的 planner 会为单次小结果集选 Nested Loop，实际跑起来却因缓存失效变成全表扫描。更糟的是，FindInBatches 不支持 EXPLAIN (ANALYZE) —— 它内部用 Rows.Next() 流式读取，无法提前获取执行计划。
实操建议：
- 导出逻辑必须脱离 GORM 的 CURD 链路，改用
pgxpool.Pool.Query直连，SQL 写死COPY (SELECT ...) TO STDOUT WITH (FORMAT CSV) - 如果必须用 GORM 做导出前校验，用
db.Raw("EXPLAIN (ANALYZE) SELECT ...").Scan(&result)单独测核心子查询 - 别依赖
FindInBatches的回调函数做实时计算，它的tx参数不是事务对象而是分片后的 *gorm.DB，Commit()会 panic
真正卡住性能的，往往不是某条 SQL 写得差，而是 GORM 的抽象层让你看不见字段映射偏差、看不见路由与 SQL 的上下文断裂、也看不见批量操作时 planner 的误判。Explain 只是镜子，照出问题，但擦镜布得自己拧干。
