Flask+SQLAlchemy插入PostgreSQL时报catInfo列不存在错误

所有报错本质是PostgreSQL标识符大小写规则、SQLAlchemy列匹配逻辑、不规范SQL写法共同导致的：

1. PostgreSQL对不加双引号的标识符（表名、列名）会自动转为全小写处理，只有被双引号包裹的标识符才会严格匹配大小写。
2. 你手写的SELECT catInfo FROM Category能正常执行，是因为语句里的catInfo没加双引号，PostgreSQL自动转成全小写catinfo，匹配到了表中实际存在的小写字段。
3. SQLAlchemy构造INSERT语句时，会自动给驼峰格式的属性名加双引号，PostgreSQL对双引号包裹的"catInfo"严格匹配大小写，自然找不到全小写的catinfo列，抛出字段不存在错误。
4. 你尝试传小写字段名catinfo时报Unconsumed column names错误，是因为SQLAlchemy是根据模型类的属性名匹配字段的，你的Category模型里只定义了驼峰的catInfo属性，没有catinfo属性，SQL编译阶段就直接报错，根本没走到数据库执行环节。
5. 手写拼接INSERT报语法错误，是因为用%直接格式化字符串时，JSON内容没有被单引号包裹，拼出来的SQL值位置直接是{开头的无引号内容，不符合SQL语法规则，同时这种写法存在严重SQL注入风险，必须禁止。

二选一即可，优先推荐第一种，符合PostgreSQL社区通用命名规范。

方案1（推荐）：统一使用小写蛇形命名 #

从根源规避大小写兼容问题：

• 修改数据库表结构，将驼峰命名字段改为蛇形小写，比如catInfo改为cat_info，表名统一使用小写category
• 同步修改SQLAlchemy模型定义，对应调整列属性名：

from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy()

class Category(db.Model):
    __tablename__ = "category"
    # 主键等其他字段自行保留
    cat_info = db.Column(db.Text) # 存储JSON字符串可以用Text类型，也可以直接用db.JSON/JSONB类型，不需要手动json.dumps
    products = db.Column(db.Text)

• 插入代码同步修改列名即可正常运行，不需要额外处理标识符转义：

catInfoString = json.dumps(catInfo)
productsString = json.dumps(products)

stmt = insert(Category).values(cat_info=catInfoString, products=productsString)
db.session.execute(stmt)
db.session.commit()

方案2：保留驼峰命名，显式指定带引号的列名 #

如果业务上必须保留驼峰格式的字段名，需要在模型定义时显式告诉SQLAlchemy生成SQL时给标识符加双引号：

class Category(db.Model):
    # 如果表名也是驼峰，也要加双引号包裹
    __tablename__ = '"Category"'
    # 列定义第一个参数传数据库实际的带双引号的列名
    catInfo = db.Column('"catInfo"', db.Text)
    products = db.Column(db.Text)

修改后原有插入代码不需要调整即可正常运行。

原生SQL执行正确写法 #

不管用什么命名规范，执行原生SQL必须用参数化查询，禁止直接字符串拼接：

# 保留驼峰时标识符要加双引号，值用%s占位，参数以元组形式传入execute方法
qry = 'INSERT INTO "Category" ("catInfo", products) VALUES (%s, %s)'
db.engine.execute(qry, (catInfoString, productsString))

如果用小写蛇形命名，SQL里不需要加双引号：

qry = 'INSERT INTO category (cat_info, products) VALUES (%s, %s)'
db.engine.execute(qry, (catInfoString, productsString))

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