如何修复SQLAlchemy Table.columns的mypy类型Any错误

你遇到的问题源于SQLAlchemy核心API的Table类是运行时动态构建的，mypy静态分析无法自动推断列的具体类型，导致columns属性被标注为ReadOnlyColumnCollection[str, Column[Any]]，触发disallow_any_expr检查。以下是几种可行的解决方式：

1. 改用SQLAlchemy声明式基类（推荐） #

声明式模型是SQLAlchemy ORM的标准用法，对类型提示的支持更完善，mypy能自动识别列的具体类型：

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

Base = declarative_base()

class A(Base):
    __tablename__ = "a"
    id_ = Column(Integer, primary_key=True)

# 访问表的列集合，mypy可正确推断类型
cols = A.__table__.columns
# 直接访问类属性更便捷，类型明确
id_column = A.id_

2. 手动为columns变量标注类型（核心API场景） #

如果必须使用核心API的Table类，可手动给cols变量补充类型注解，明确列的类型映射：

import sqlalchemy as sa
from sqlalchemy.sql.schema import ReadOnlyColumnCollection, Column

t = sa.Table("a", sa.MetaData(), sa.Column("id_", sa.Integer))
# 手动指定集合内列的类型为Column[int]
cols: ReadOnlyColumnCollection[str, Column[int]] = t.columns

注意这种方式需要你自己维护类型与实际列的一致性，适合简单场景。

3. 升级到SQLAlchemy 2.0+版本 #

SQLAlchemy 2.0对类型提示做了大幅优化，核心API也支持更精准的类型推断。可以结合Annotated明确列的Python类型：

from typing import Annotated
import sqlalchemy as sa
from sqlalchemy.orm import mapped_column

t = sa.Table(
    "a",
    sa.MetaData(),
    sa.Column("id_", Annotated[int, mapped_column(sa.Integer)]),
)

通过Annotated，mypy能获取到列的具体Python类型，避免出现Any。

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