升级MariaDB至10.11后，SQLAlchemy操作row_number列报错如何解决？

问题根源 #

MariaDB 10.11将row_number新增为保留关键字（此前10.5版本未严格限制），直接使用未转义的列名会触发语法错误，必须用反引号（或双引号，取决于SQL模式）包裹标识符。

无需修改业务代码的解决方案 #

方案1：全局强制SQLAlchemy自动给所有标识符加反引号

通过自定义MySQL方言，让SQLAlchemy生成的所有列名、表名都自动用反引号包裹，彻底避免关键字冲突：

from sqlalchemy import create_engine
from sqlalchemy.dialects.mysql import MYSQLDialect

# 自定义方言，启用全局标识符引用
class QuotedMYSQLDialect(MYSQLDialect):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.identifier_preparer.quote = True

# 创建引擎时使用自定义方言
engine = create_engine(
    "mysql+pymysql://your_user:your_pass@your_host/your_db",
    dialect=QuotedMYSQLDialect()
)

这个方案不需要修改任何模型定义或查询代码，所有SQL输出都会自动给标识符加反引号。

方案2：通过设置SQL模式兼容标识符引用

在数据库连接初始化时设置ANSI_QUOTES模式，让MariaDB将双引号视为标识符引用符号，SQLAlchemy会自动为关键字列添加双引号：

from sqlalchemy import create_engine

engine = create_engine(
    "mysql+pymysql://your_user:your_pass@your_host/your_db",
    connect_args={"init_command": "SET sql_mode=ANSI_QUOTES"}
)

此方案无需修改SQLAlchemy的方言或模型，仅通过连接参数调整数据库行为。

方案3：仅给特定列启用引用（适合局部调整）

如果不想全局修改，仅针对row_number列设置自动引用，可在模型定义时给该列添加quote=True参数：

from sqlalchemy import Column, Integer
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class Kae(Base):
    __tablename__ = 'kae'
    id = Column(Integer, primary_key=True)
    row_number = Column(Integer, quote=True)  # 强制该列被引用

此方案需要修改模型代码，但影响范围最小。

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