如何在SQLAlchemy 2.x模型中更新布尔属性并通过MyPy检查？

问题原因 #

MyPy将模型属性is_archived识别为Column[bool]类型，但实际赋值的是bool值，两者类型不匹配。这是因为旧版SQLAlchemy的字段声明方式（直接用Column）无法让MyPy正确推断ORM实例属性的实际值类型，只能识别到Column对象本身的类型。

解决方案 #

方案1：使用SQLAlchemy ORM 2.0风格的类型注解（推荐） #

改用Mapped和mapped_column来声明模型字段，这是SQLAlchemy 1.4+版本推荐的写法，能让MyPy准确推断属性的实际值类型。

修改模型定义：

from sqlalchemy.orm import Mapped, mapped_column
from sqlalchemy import Boolean
from sqlalchemy.ext.declarative import Base

class WorkspaceModel(Base):
    __tablename__ = "workspace"

    # 其他字段保持不变...
    is_archived: Mapped[bool] = mapped_column(Boolean, default=False)

修改后，MyPy会识别workspace.is_archived的类型为bool，赋值new_value（bool类型）就不会再报错。

方案2：临时忽略类型检查（不推荐） #

如果暂时无法修改模型结构，可以在赋值语句后添加类型忽略注释，强制MyPy跳过该位置的类型检查：

workspace.is_archived = new_value  # type: ignore[assignment]

这种方式只是绕过错误，没有从根本上解决类型推断问题，长期维护不建议使用。

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