SQLAlchemy更新text字段报错：text类型在等于运算符中不兼容

数据老陈

2026-5-27

解决SQL Server text类型字段更新时的ProgrammingError问题

我来帮你拆解这个问题并给出针对性的解决方案：

问题根源分析

为什么UPDATE语句里会出现memotext在WHERE子句中？
你用query(...).one()获取对象后修改字段再提交，SQLAlchemy默认会采用快照更新策略：它会把查询时获取的所有原始字段值都放到WHERE条件里，确保你更新的是查询到的那一行（防止并发更新冲突）。这就是为什么明明你只过滤了memosern1，生成的SQL却包含了memotext等其他字段。
为什么text类型不能用等于运算符？
SQL Server的text是一个过时的大文本类型，它不支持在WHERE子句中直接用=进行等值比较——这就是错误提示里“text与text类型在等于运算符中不兼容”的核心原因。而新增操作不需要WHERE条件，所以不会触发这个问题。

解决方案（按推荐程度排序）

方案1：改用直接更新的方式（最快解决）

放弃先查询对象再修改的方式，直接使用SQLAlchemy的批量更新语法，这样生成的UPDATE语句只会用你指定的过滤条件作为WHERE子句，不会包含memotext：

# 替换原来的查询+修改代码
request.databaseSession.query(Tmemo).filter(Tmemo.memosern1 == serial).update(
    {"memotext": newtext}
)
request.databaseSession.commit()

方案2：将text字段替换为varchar(max)（推荐长期方案）

SQL Server官方已经不推荐使用text类型，建议用varchar(max)替代（它支持所有text的功能，且兼容所有常规字符串操作）：

第一步：修改数据库表结构，把memotext的类型从text改为varchar(max)

第二步：更新你的SQLAlchemy模型定义，把对应的字段类型调整为：

from sqlalchemy import String
from sqlalchemy.dialects.mssql import VARCHAR

# 方式1：直接用String不指定长度（SQLAlchemy会映射为varchar(max)）
memotext = Column(String)
# 方式2：显式指定MSSQL的VARCHAR(max)
memotext = Column(VARCHAR(MAX))

这样不仅能解决当前的更新问题，还能避免后续使用text类型带来的其他限制。

方案3：让SQLAlchemy更新时忽略memotext字段

如果你必须保留text类型，可以在模型的memotext字段上添加compare=False参数，告诉SQLAlchemy在生成更新的WHERE条件时不要包含这个字段：

class Tmemo(Base):
    __tablename__ = 'tmemo'
    memosern1 = Column(String, primary_key=True)
    memosern2 = Column(String, primary_key=True)
    memotype = Column(String, primary_key=True)
    # 添加compare=False，更新时不会把该字段放入WHERE子句
    memotext = Column(Text, compare=False)

之后你再用原来的查询-修改-提交流程就不会报错了，但要注意：这种方式会关闭对memotext字段的并发冲突检测，如果有其他进程同时修改同一条记录的memotext，你的更新会直接覆盖掉对方的修改。

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