bun 的 schema 感知能力在微服务中特别有用，因其将 schema 显式写入结构体标签（如 bun:"table:users"）和查询链（如 tableexpr("tenant_123.users")），避免 gorm 全局缓存污染与 raw sql 手动拼接风险；安全支持 tenant-aware 切换需为每个租户初始化独立 *bun.db 实例并缓存，连接建立后立即执行 set search_path to tenant_123，确保 join、relation 等自动继承当前 schema，同时跨 schema 查询须显式用 tableexpr("public.xxx") 或 columnexpr 参数化处理，严禁字符串拼接。
为什么 Bun 的 Schema 感知能力在微服务里特别有用
因为微服务天然需要多租户或按业务分 schema，而 Bun 不靠魔法反射猜表名，而是把 schema 显式写进结构体标签和查询链中——bun:"table:tenant_123.users" 或 db.NewSelect().TableExpr("tenant_123.users AS u")，既避免 GORM 那种全局 TableName() 缓存污染，也不用像 raw SQL 那样手动拼接前缀。它让 schema 成为模型定义的一部分，而不是运行时“猜”出来的上下文。
如何用 Bun 安全地支持 tenant-aware schema 切换
别把 tenant_id 塞进 context 然后在 DAO 层动态拼 tenant_123.users——容易漏、难测、ORM 关系加载会失效。正确做法是：每个租户初始化一个独立的 *bun.DB 实例，并缓存到 sync.Map 里：
- 构造 DSN 时不带 dbname，只指定 host/port/user/password；连接建立后立刻执行
conn.Exec("SET search_path TO tenant_123") - 或者更稳妥：用
bun.WithDialect(pgdriver.New())+ 自定义pgdriver.Config，在OnConnect回调里设search_path - 结构体标签里不硬编码 schema，保持
bun:"table:users"；真正生效靠连接级search_path，不是模型层字符串替换 - 关系预加载（如
.Relation("Orders")）能正常工作，因为 Bun 生成 JOIN 时会复用当前连接的search_path，不用你手动改tenant_123.orders
Bun 的 TableExpr 和 ColumnExpr 在多 schema 场景下的实际用法
当需要跨 schema 查询（比如租户统计视图或审计表在公共 schema），不能依赖 search_path，得显式指定：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
db.NewSelect().TableExpr("public.tenant_metrics AS m")—— 直接写死 schema 名，绕过search_path -
.ColumnExpr("tenant_123.users.name, public.roles.title")—— 多 schema 字段混选，Bun 自动参数化，无注入风险 - 注意：
TableExpr会跳过结构体上的bun:"table:..."标签，优先级更高；但Relation加载仍走模型定义，所以跨 schema 关联需手动Join+ColumnExpr - 别在
TableExpr里拼变量，如fmt.Sprintf("tenant_%s.users", tenantID)—— 这等于放弃 Bun 的 SQL 安全机制，应改用参数化 WHERE 或连接级search_path
Schema 级迁移和 Bun 的 migrate.Migrator 怎么配合
Bun 的迁移工具默认操作当前连接的 schema，所以必须为每个租户单独跑迁移：
- 不要共用一个
migrate.Migrator实例；每个租户 DB 实例配一个专属migrator - 迁移文件里写
CREATE TABLE users (...)即可，不必加tenant_123.前缀——search_path已确保建在目标 schema 下 - 回滚时同样依赖连接上下文，
migrator.Rollback(ctx, 1)会删掉当前 schema 里的表，不会误删其他租户 - 首次初始化租户时，先
CREATE SCHEMA IF NOT EXISTS tenant_123，再调migrator.Init(ctx)，否则迁移会报错
最易被忽略的是：Bun 的 schema 感知完全依赖连接状态，不是模型定义。一旦连接复用或 search_path 未重置，后续所有查询都会跑偏——务必在租户 DB 实例创建后立即确认 SELECT current_schema() 返回值。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
