Beego对接PostgreSQL需确保三点：一是必须以_ "github.com/lib/pq"形式显式导入驱动且置于main.go的import块；二是连接串须为libpq格式（如user=... port="5432" sslmode=disable），不可套用MySQL DSN；三是模型主键需加orm:"auto"标签，否则插入报NOT NULL错误。
Beego 对接 PostgreSQL 不是“改个驱动名就能跑”，关键在连接串格式、驱动注册顺序、字段类型映射这三点，漏掉任一环节都会报 driver: unknown driver "postgres" (forgotten import?) 或 ERROR: relation "xxx" does not exist。
PostgreSQL 驱动必须显式导入且位置正确
很多人只写 orm.RegisterDriver("postgres", orm.DR_Postgres) 就以为够了，但 Go 的包导入机制要求：驱动包必须以空白标识符（_）方式导入，且该导入语句不能被编译器优化掉——也就是说，它得出现在 init() 函数所在文件的 import 块里，且不能只放在 models 或 routers 文件中。
-
main.go的import块里必须包含：_ "github.com/lib/pq" - 不能只在
models/models.go里导入驱动，因为main.init()执行时还不会触发 models 包的初始化 - 如果用 Bee 工具生成项目，
main.go默认不带该导入，需手动补上
PostgreSQL 连接串格式不能套用 MySQL 写法
MySQL 的 DSN 是 user:pass@tcp(host:port)/db?charset=utf8，而 PostgreSQL 使用的是 libpq 风格的 key=value 参数拼接，常见错误是混用或漏掉必要参数。
- 必须包含
user、password、dbname、host、port，缺一不可 -
sslmode=disable在本地开发时建议显式加上，否则默认尝试 SSL 连接，可能卡住或报server does not support SSL, but SSL was requested - 端口必须是整数字符串（如
"5432"），不能写成5432（Go 会报类型不匹配） - 示例正确写法：
"user=postgres password=mypass dbname=myapp host=127.0.0.1 port=5432 sslmode=disable"
自动建表（RunSyncdb）对 PostgreSQL 有隐含限制
orm.RunSyncdb("default", false, true) 在 PostgreSQL 下不会创建序列（sequence）或设置主键默认值为 NEXTVAL('xxx_id_seq')，导致插入时若没显式赋值 ID，会报 null value in column "id" violates not-null constraint。
- 解决办法：模型字段加
orm:"auto"标签，例如Id int64 `orm:"auto"` - PostgreSQL 不支持
size对整型字段生效，orm:"size(10)"对int无效，只会作用于string类型 - 如果已有表结构，
RunSyncdb不会修改字段类型或约束，仅检查并创建缺失表——它不是迁移工具
字段命名与 PostgreSQL 的大小写敏感性冲突
Beego ORM 默认将 struct 字段名转为小写下划线（snake_case）建表，比如 CreatedAt → created_at。但如果你手动写了大驼峰字段名又没加 tag，PostgreSQL 会按字面建带引号的列名（如 "CreatedAt"），后续查询全失败。
- 统一做法：所有字段都加
ormtag 显式指定列名，例如CreatedAt time.Time `orm:"column(created_at);type(datetime)"` - 避免使用
Id以外的首字母大写字段名而不加 tag，否则 ORM 生成的 SQL 会查不到列 - PostgreSQL 默认忽略双引号外的大小写，但一旦建表用了引号，后续所有引用都必须带引号且大小写严格匹配
最常被跳过的其实是 sslmode=disable 和 orm:"auto" 这两个点——前者让连接卡死在 handshake 阶段，后者让插入直接报 NOT NULL 错误，它们都不报驱动相关异常，容易误判为配置或网络问题。
