SQLAlchemy类型装饰器报‘object has no attribute self_group’及jsonbool适配问题

这个问题我之前也碰到过，SQLAlchemy 1.2对表达式类型的检查确实比1.1严格了不少。原来的jsonbool类继承自str，在1.1里SQLAlchemy会直接把它当成字符串处理，但1.2开始要求参与查询表达式的对象必须是合法的SQL表达式元素，而普通字符串子类并没有实现self_group这类SQLAlchemy需要的方法，所以才会抛出这个错误。

下面给你两种可行的解决方案，你可以根据自己的代码情况选择：

方案一：给jsonbool类添加SQLAlchemy表达式接口支持 #

直接修改你的jsonbool类，让它实现SQLAlchemy需要的方法，这样就能在表达式中正常使用了：

from sqlalchemy.sql.elements import LiteralClause

class jsonbool(str):
    def __bool__(self):
        return True if self == 'true' else False
    
    def __clause_element__(self):
        # 告诉SQLAlchemy如何将这个对象转换为SQL字面量
        return LiteralClause(self)
    
    def self_group(self):
        # 实现self_group方法，用于复杂表达式中的分组
        return self.__clause_element__()

这样修改后，原来的查询代码不需要任何改动，SQLAlchemy就能正确识别jsonbool实例作为SQL表达式的一部分了。

方案二：使用SQLAlchemy TypeDecorator重构类型处理（推荐长期方案） #

如果你的代码库允许做一些重构，更优雅的方式是使用SQLAlchemy的TypeDecorator来封装JSON布尔值的处理，这样完全符合SQLAlchemy的类型系统设计：

from sqlalchemy import TypeDecorator, String, Column

class JsonBoolean(TypeDecorator):
    # 底层使用String类型存储
    impl = String

    def process_bind_param(self, value, dialect):
        # 将Python的bool值转换为存储的字符串
        return 'true' if value else 'false'
    
    def process_result_value(self, value, dialect):
        # 将存储的字符串转换回Python的bool值
        return value == 'true'

# 在定义表的时候使用这个类型
class SomeTable(Base):
    __tablename__ = 'some_table'
    ABooleanColumn = Column(JsonBoolean)

之后查询的时候，你就可以直接使用Python原生的bool值进行比较，完全不需要jsonbool类了：

# 直接用True/False查询
query.filter(SomeTable.ABooleanColumn == True).all()
# 或者从数据库取出的ABooleanColumn直接是bool类型
for row in query.all():
    print(type(row.ABooleanColumn))  # <class 'bool'>

这个方案不仅解决了升级后的兼容性问题，还让代码更符合SQLAlchemy的最佳实践，后续维护起来也更方便。

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