混合声明式与命令式映射时，sqlalchemy_continuum无法用于命令式映射类

1. 解决Comment类无metadata属性的报错 #

命令式映射的领域类默认不会自动绑定metadata，这是手动设置__versioned__时触发AttributeError的核心原因。映射时需要显式给类绑定metadata：

from sqlalchemy import MetaData, Table, Column, Integer, String
from sqlalchemy.orm import registry

# 全局或模块级的metadata实例
metadata = MetaData()
mapper_registry = registry(metadata=metadata)

# 定义Comment表结构
comment_table = Table(
    "comment",
    metadata,
    Column("id", Integer, primary_key=True),
    Column("content", String(255)),
    # 按需添加其他字段
)

# 领域类Comment
class Comment:
    pass

# 执行命令式映射
mapper_registry.map_imperatively(Comment, comment_table)
# 关键：手动给Comment类绑定metadata属性
Comment.metadata = metadata

2. 手动为命令式类配置审计日志 #

完成映射后，需要显式触发sqlalchemy_continuum的版本化配置，确保生成对应的版本类和审计表：

import sqlalchemy_continuum

# 初始化Continuum（user_cls根据你的业务需求配置，不需要可设为None）
sqlalchemy_continuum.make_versioned(user_cls=None)

# 给Comment类添加版本化配置
Comment.__versioned__ = {
    "metadata": metadata,  # 关联和Comment一致的metadata
    "base_classes": [],  # 无自定义基础版本类则留空
    # 可选：添加track_property_modifications等其他配置
}

# 手动生成版本类
from sqlalchemy_continuum import version_class
CommentVersion = version_class(Comment)

3. 调整Continuum初始化时机 #

如果是逐步从声明式转命令式，必须确保所有映射类（声明式+命令式）都完成映射后，再调用make_versioned()。如果已经提前初始化了Continuum，需要对后续新增的命令式类手动执行上述版本化配置步骤。

4. 关于查询效率问题的补充优化 #

仓库模式导致多查询的问题，不一定非要全量转命令式映射才能解决：

• 在仓库方法中直接使用ORM的joinedload/selectinload等关联加载策略，一次查询即可获取用户及其关联数据
• 声明式映射也可以通过registry.map_declarative实现领域类和映射配置的分离，同样能避免领域层与数据库直接耦合

内容的提问来源于stack exchange，提问作者J. Ed