RDKit PostgreSQL 扩展在 Postgres 17 中的兼容性问题解析

近期在 PostgreSQL 17.0 版本发布后，用户反馈 RDKit 的 PostgreSQL 扩展（rdkit-cartridge）在创建时出现错误。本文将深入分析该问题的技术背景、成因及解决方案。

问题现象

当用户在 PostgreSQL 17 环境中执行 CREATE EXTENSION rdkit; 命令时，系统会报错：

ERROR:  commutator operator = is already the commutator of operator =

错误日志显示该问题发生在操作符定义冲突检测环节。

技术背景

PostgreSQL 17 引入了一项重要的约束强化（commit 2b5154be），加强了对操作符 commutator（交换子）和 negator（否定子）属性的唯一性校验。这项改进旨在防止同一操作符被重复定义为其他操作符的交换子或否定子。

在 RDKit 的 PostgreSQL 扩展中，存在两个分子比较操作符：

1. 标准等值操作符 =
2. 特殊等值操作符 @=

这两个操作符都：

• 使用相同的底层函数 mol_eq
• 声明 = 作为交换子
• 声明 <> 作为否定子

这种设计自 2011 年以来一直存在，但在 PostgreSQL 17 更严格的校验机制下暴露了兼容性问题。

问题本质

根本矛盾在于：

1. PostgreSQL 17 要求交换子/否定子关系必须唯一
2. RDKit 中 = 和 @= 都试图声明相同的交换子关系

这类似于在关系型数据库中出现重复的唯一键冲突。

解决方案

该问题已在 RDKit 主分支中修复，主要调整包括：

1. 移除冗余的操作符定义
2. 确保每个操作符的交换子和否定子关系保持唯一性

对于用户而言，解决方案是：

1. 升级到包含修复的 RDKit 版本
2. 或暂时回退到 PostgreSQL 16 及以下版本

技术启示

这个案例展示了：

1. 数据库扩展开发需要考虑未来核心系统的约束变化
2. 长期稳定的代码可能隐藏着潜在的兼容性风险
3. 操作符重载时需要谨慎处理关系属性

PostgreSQL 的这类改进虽然可能带来短期兼容性问题，但从长远看有助于提高系统的健壮性和一致性。作为扩展开发者，应当及时跟进核心系统的变更，并在设计时预留足够的灵活性。

总结

RDKit 团队快速响应了 PostgreSQL 17 的兼容性问题，体现了开源社区的敏捷性。对于科学计算领域的数据库扩展开发者，这个案例也提醒我们需要：

1. 建立持续集成测试覆盖多版本数据库
2. 关注上游数据库的重要变更
3. 在操作符设计时考虑未来的可扩展性