本文介绍在 django/peewee 等 orm 中，当使用 `arrayfield` 存储多值（如用户 id 列表）时，如何实现「数组内容相同即视为重复」的真正唯一性校验——即 `[1,2]` 与 `[2,1]` 在相同 `chat_id` 下应被拒绝插入。
直接在 PostgreSQL 上对 ArrayField（如 users）建立普通唯一索引（如 ('users', 'chat_id')）无法满足需求，因为 PostgreSQL 将 [1,2] 和 [2,1] 视为两个不同的数组值——数组是有序结构，其索引和顺序属于值的一部分。因此，即使元素完全相同但顺序不同，数据库仍会允许插入，导致逻辑上的“重复婚姻关系”未被拦截。
✅ 推荐方案：范式化建模（推荐用于生产环境）
最可靠、高效且数据库无关的解法是避免在单字段中存储无序集合，转而采用一对多关系建模：
from peewee import *
class Marriage(BaseModel):
chat_id = BigIntegerField()
user_id = BigIntegerField()
class Meta:
# 复合唯一约束：同一 chat_id 下不允许重复 user_id
indexes = (
(('chat_id', 'user_id'), True),
)插入时拆解数组：
# 原意：创建 chat_id=1 的婚姻，关联用户 [1, 2]
for uid in [1, 2]:
Marriage.create(chat_id=1, user_id=uid)查询所有成员（等价于原 Marriage.objects.filter(chat_id=1).values_list('users', flat=True)）：
uids = [row[0] for row in (
Marriage
.select(Marriage.user_id)
.where(Marriage.chat_id == 1)
.tuples()
)]
# uids → [1, 2]（顺序由查询决定，可加 ORDER BY 显式控制）✅ 优势：
- 唯一性由数据库原生保障（UNIQUE (chat_id, user_id)），零误判；
- 支持高效查询、删除单个成员、添加新成员；
- 兼容任意 ORM 和 SQL 标准；
- 可轻松扩展（如添加 joined_at 时间戳、role 字段等）。
⚠️ 替代方案（不推荐用于核心业务）
若因历史原因必须保留 ArrayField，可通过 PostgreSQL 函数索引 + 排序归一化实现（需手动维护）：
-- 创建归一化函数：将整数数组排序后作为唯一键 CREATE OR REPLACE FUNCTION sorted_users(bigint[]) RETURNS bigint[] AS $$ SELECT ARRAY(SELECT unnest($1) ORDER BY 1); $$ LANGUAGE sql IMMUTABLE; -- 在 (sorted_users(users), chat_id) 上建立唯一函数索引 CREATE UNIQUE INDEX idx_marriage_unique_sorted ON marriage USING btree (sorted_users(users), chat_id);
⚠️ 注意事项：
- Peewee/Django 不原生支持函数索引，需通过 RunSQL 迁移手动创建；
- sorted_users() 必须标记为 IMMUTABLE，否则无法建索引；
- 数组元素类型需一致（如全为 bigint），且不能含 NULL（需提前过滤）；
- 性能略低于范式化方案，且调试与迁移复杂度更高。
✅ 总结
| 方案 | 唯一性保障 | 可维护性 | 性能 | 推荐度 |
|---|---|---|---|---|
| 范式化（一对多） | ✅ 完美（DB 层强制） | ✅ 高（标准 ORM 操作） | ✅ 优秀（索引高效） | ⭐⭐⭐⭐⭐ |
| 函数索引归一化 | ✅ 可行（依赖函数正确性） | ❌ 低（需 DBA 协作、易出错） | ⚠️ 中等（函数调用开销） | ⚠️ 仅限临时过渡 |
强烈建议采用范式化设计：它不仅解决了当前的唯一性问题，更使数据模型清晰、可扩展、可审计，符合关系型数据库最佳实践。
