继承SQLAlchemy的Table类报错：'DevicesTable'无'_columns'属性

尝试继承SQLAlchemy的Table类自定义DevicesTable，代码及报错如下：

自定义Table子类代码 #

import os
from sqlalchemy import Column, Integer, MetaData, Table, Text

class DevicesTable(Table):
    _name = 'devices'
    def __init__(self):
        Table.__init__(self, self._name,
            MetaData(schema=os.environ["DB_SCHEMA"]),
            Column('id', Integer, primary_key=True),
            Column('timezone', Text)
        )

实例化方式 #

table = DevicesTable()

报错信息 #

AttributeError: 'DevicesTable' object has no attribute '_columns'

直接实例化Table类用相同配置可正常运行，当前环境为Python 3.8 + SQLAlchemy 2.0.4。

SQLAlchemy的Table类依赖专属元类TableMeta处理列定义、属性绑定等核心逻辑，直接重写__init__会绕过元类的初始化流程，导致_columns等关键属性未被正确创建。Table本身并非设计用于直接继承，这种用法不符合SQLAlchemy的设计规范。

方案1：用工厂函数替代继承（推荐） #

这是SQLAlchemy官方建议的方式，简单且避免继承陷阱：

import os
from sqlalchemy import Column, Integer, MetaData, Table, Text

def create_devices_table():
    metadata = MetaData(schema=os.environ["DB_SCHEMA"])
    return Table(
        'devices',
        metadata,
        Column('id', Integer, primary_key=True),
        Column('timezone', Text)
    )

# 创建表实例
table = create_devices_table()

方案2：正确继承Table（需遵循元类逻辑） #

若必须继承，不要重写__init__，而是通过类属性定义表结构，实例化时传递必要参数：

import os
from sqlalchemy import Column, Integer, MetaData, Table, Text

metadata = MetaData(schema=os.environ["DB_SCHEMA"])

class DevicesTable(Table):
    __tablename__ = 'devices'
    __table_columns__ = (
        Column('id', Integer, primary_key=True),
        Column('timezone', Text),
    )

# 实例化时需传入表名、metadata和列定义
table = DevicesTable(DevicesTable.__tablename__, metadata, *DevicesTable.__table_columns__)

方案3：使用声明式基类（ORM场景首选） #

如果是用于ORM开发，推荐使用SQLAlchemy的声明式基类，这是更常用的ORM表定义方式：

import os
from sqlalchemy import Column, Integer, Text
from sqlalchemy.orm import declarative_base

# 声明基类并设置schema
Base = declarative_base()
Base.metadata.schema = os.environ["DB_SCHEMA"]

class DevicesTable(Base):
    __tablename__ = 'devices'
    
    id = Column(Integer, primary_key=True)
    timezone = Column(Text)

# 若需直接获取Table实例，可通过__table__属性
table = DevicesTable.__table__

内容的提问来源于stack exchange，提问作者Chris