sqlacodegen漏外键和自定义类型因默认不反射外键约束且不识别JSONB/ENUM/ARRAY；eralchemy解析pg_dump DDL时漏ALTER TABLE外键；sqlmodel/pydantic模型无元数据反射，无法生成关系线。
逆向工程生成ER图时，sqlacodegen 为什么漏掉外键和自定义类型？
因为默认不启用反射外键约束，且对 jsonb、enum、array 等扩展类型无原生识别。postgresql 的 information_schema 不暴露 enum 值列表，sqlacodegen 只能猜成 string。
- 加
--views和--no-indexes没用，关键要传--tables显式指定表，否则某些视图或分区表会被跳过 - PostgreSQL 用户必须加
--noinflect，否则表名user_profiles会被转成类名UserProfile，但外键字段仍叫user_profile_id，导致关系推导失败 - 遇到
JSONB字段，sqlacodegen输出Column(JSON)，但实际需手动改成Column(JSONB)并补from sqlalchemy.dialects.postgresql import JSONB
pg_dump --schema-only + eralchemy 生成的ER图连线全是错的
因为 eralchemy 解析 SQL DDL 时，只认标准 FOREIGN KEY ... REFERENCES 语法，而 pg_dump 默认用 ALTER TABLE ... ADD CONSTRAINT 分离建表和外键，它会漏掉这些语句。
- 必须加
pg_dump --schema-only --no-tablespaces --no-owner --no-privileges --column-inserts，但真正有效的是--inserts（强制内联约束）或改用--no-tablespaces配合--no-security-labels减少干扰 -
eralchemy对复合主键支持弱，若表有(a,b) PRIMARY KEY，它可能把a当成唯一主键，导致外键匹配错误 - 生成前先跑一遍
psql -c "\d+ table_name"确认外键是否真实存在于pg_constraint，有些“逻辑外键”只是命名约定，没建约束
用 sqlmodel 或 pydantic 模型反推ER图，为什么关系线全断了？
因为 sqlmodel 的 Relationship 是运行时声明，不参与数据库元数据反射；pydantic 更是纯校验层，完全没 DB 层语义。
- 不要指望
sqlmodel类里的posts: List["Post"] = Relationship(back_populates="author")能被任何 ER 工具自动识别——它们不是 SQLAlchemy 的relationship()，也不写入__table__ - 若坚持用代码优先，得先用
sqlmodel的SQLModel.metadata.create_all()同步到 DB，再用erdiagram或pg_er从实际 schema 反向读取 - 常见陷阱：
pydantic.BaseModel里写了user_id: int，但没配ForeignKey，工具无法判断这是外键还是普通字段
PostgreSQL 自定义 ENUM 和 RANGE 类型在ER图里怎么显示才准确？
标准工具几乎都不处理，必须手动注入元数据。ER 图工具依赖 pg_type 和 pg_enum，但多数 Python 工具只查 information_schema.columns，后者不包含枚举值。
- 临时方案：用
psql -c "SELECT t.typname, e.enumlabel FROM pg_type t JOIN pg_enum e ON t.oid = e.enumtypid WHERE t.typname = 'my_status';"提取枚举值，再贴进 ER 图工具的注释字段 -
RANGE类型如int4range会被识别为String或NullType，需在生成后手动替换为Range并导入from sqlalchemy.dialects.postgresql import INT4RANGE - 真正可靠的路径是绕过 Python 工具，直接用
pgAdmin的图形化 ER 工具（右键数据库 → “ERD for Database”），它原生读pg_catalog，能正确渲染ENUM值和RANGE边界
最麻烦的不是画不出图，而是图里每条线都得验证一次数据库里是否存在对应约束——没有 pg_constraint 记录的关系，再像外键也没用。
