PostgreSQL的HSTORE字段更新必须用hstore()函数与||拼接，不可用下标赋值；覆盖键值用||自动生效；删除键须用delete()函数；ORM全量写入有并发风险，应走原生SQL或func.hstore/func.delete。
直接用 UPDATE 语句更新 HSTORE 字段的键值对
PostgreSQL 的 HSTORE 类型不支持像 JSON 那样用点号或方括号直接赋值，必须用函数操作。最常用的是 hstore(text, text) 构造单个键值对，再用 ||（拼接运算符）合并到现有值中。
常见错误是写成：UPDATE mytable SET attributes['key'] = 'val' WHERE id = 1 —— 这会报错，因为 HSTORE 不支持下标赋值语法。
- 正确做法：用
||合并新键值，保留旧数据：UPDATE mytable SET attributes = attributes || hstore('key', 'val') WHERE id = 1 - 如果要覆盖已有 key，
||会自动覆盖（后项优先），无需先delete() - 若只更新部分键、其他键不变，且不确定原值是否存在，直接拼接最安全；不要先
SELECT再拼字符串再UPDATE，容易并发覆盖
hstore 字段在 SQLAlchemy 中保存失败：JSON 输入格式不对
Flask-Admin 或自定义表单把 HSTORE 渲染为 TextAreaField 后，用户输入的是类似 {"a": "1", "b": "2"} 的 JSON 字符串，但 PostgreSQL 的 HSTORE 不接受标准 JSON 格式 —— 它要求的是 "a"=>"1", "b"=>"2" 这种字符串，或通过 hstore() 函数构造。
所以 json.loads() 解析后直接赋给 model.attributes 会失败，因为 SQLAlchemy 期望的是 dict，但底层驱动仍需转成 PostgreSQL 可识别的 hstore 字面量。
- 确保模型字段类型是
Column(HSTORE)，不是Column(JSON)或Column(String) - 在
on_model_change中，别用json.loads()；改用ast.literal_eval()处理形如{'a': '1'}的字符串（注意单引号），或更稳妥地用psycopg2.extras.hstore工具函数 - 推荐方式：在视图里接收 JSON 字符串 →
json.loads()得到dict→ 直接赋值给 model 字段：model.attributes = json.loads(form.attributes.data)，前提是 SQLAlchemy 的HSTORE类型已正确注册类型适配器（通常 flask-sqlalchemy + psycopg2 自带）
用 update_columns 只更新 HSTORE 中的部分键，避免全量覆盖
ORM 层调用 save() 或 update_attributes() 会把整个 attributes 字段当做一个整体写入，哪怕你只改了一个键，也会把当前 Python dict 全量刷进数据库 —— 如果并发修改，极易丢失他人刚写入的其他键。
真正“只更新一个键”的做法，是绕过 ORM，走原生 SQL 更新：
- 用
db.session.execute()执行：UPDATE mytable SET attributes = attributes || hstore(:key, :val) WHERE id = :id - 或者用 SQLAlchemy 的
update().values()配合func.hstore()：update(MyTable).values(attributes=MyTable.attributes.op('||')(func.hstore('key', 'val'))) - 绝对不要依赖
update_columns(attributes={'key': 'val'})—— 这会把整个字典替换掉原有 hstore，不是“追加”，而是“重置”
删除 HSTORE 中某个键：用 delete() 函数，不是 pop()
Python 里的 dict.pop('key') 在 SQLAlchemy 的 HSTORE 字段上无效。数据库层面删键必须用 PostgreSQL 内置函数 delete(hstore, text)。
例如，想删掉 temp_flag 键：
- SQL 写法：
UPDATE mytable SET attributes = delete(attributes, 'temp_flag') WHERE id = 1 - 在 SQLAlchemy 中：
update(MyTable).values(attributes=func.delete(MyTable.attributes, 'temp_flag')) - 注意：
delete()对不存在的键静默忽略，不会报错；但如果你先SELECT再手动构造新 dict 删除键，就又回到并发风险的老路
最易被忽略的一点：HSTORE 的键名和值都是文本类型，大小写敏感，且不能含控制字符或未转义的双引号。传入前最好用 str.strip() 和正则简单校验，否则 hstore() 构造时可能静默截断或报错。
