PocketBase中部分索引(Partial Index)的使用注意事项

在PocketBase数据库系统中，部分索引(Partial Index)是一个强大的功能，但使用时需要注意一些特殊行为。部分索引是SQLite提供的一种高级索引功能，它允许我们只为满足特定条件的行创建索引，而不是为整个表创建索引。

问题现象

开发者在使用PocketBase时发现，尝试创建一个带有WHERE条件(user IS NOT NULL)的部分索引时，系统仍然会对所有记录执行唯一性检查，即使条件不满足也会报唯一性错误。

原因分析

这实际上与PocketBase的字段设计特性有关。在PocketBase中，除了json类型的字段外，所有字段都是非可为空的(non-nullable)。这意味着：

1. 每个字段都有一个默认的零值
2. 系统会自动为字段设置默认值，而不是保持NULL状态
3. 因此"IS NOT NULL"条件实际上对PocketBase字段没有意义

解决方案

针对这种情况，正确的做法是修改WHERE条件，改为检查字段是否不等于其零值。例如：

CREATE UNIQUE INDEX idx_members_user_org ON members (
  user,
  organization
) WHERE user != ''

对于不同类型的字段，零值也不同：

• 文本类型：空字符串('')
• 数字类型：0
• 布尔类型：false

最佳实践

1. 在PocketBase中使用部分索引时，永远不要使用"IS NULL"或"IS NOT NULL"条件
2. 应该根据字段类型检查其零值状态
3. 对于文本字段，检查是否为空字符串
4. 对于数字字段，检查是否为0
5. 对于布尔字段，检查是否为false

理解PocketBase的这种设计特性，可以帮助开发者更有效地利用部分索引功能，同时避免不必要的唯一性约束冲突。