求助：Metabase/Clojure中Unfreezable type: org.postgresql.jdbc.PgArray错误排查

我之前在Metabase里踩过完全一样的坑，当时用PostgreSQL的TEXT[]类型时不定期报这个错，折腾了好久才搞清楚背后的逻辑，跟你分享下：

错误的核心本质 #

这个错误根源在于Clojure的序列化（freeze/unfreeze）机制——Metabase会用这套机制缓存查询结果、在不同进程间传递数据，而PostgreSQL JDBC驱动返回的org.postgresql.jdbc.PgArray对象，并不在Clojure默认支持的可序列化类型列表里。当Metabase尝试把包含这个对象的查询结果序列化时，就会直接抛出“Unfreezable type”的错误。

为什么会“不定期”出现？ #

这是最让人困惑的点，我排查下来发现几个可能的触发条件：

• 缓存触发时机：Metabase不是每次查询都会序列化结果，只有当结果需要存入缓存（比如重复查询相同内容）或者跨节点传递时才会触发序列化。所以有时候查同一个SQL没问题，过一会儿再查就报错，本质是这次触发了缓存逻辑。
• 数组的内部状态：当数组是空数组、或者元素是非常简单的字符串时，JDBC驱动可能会把它隐式转换成Clojure原生的集合类型（比如空向量），这种情况下序列化就没问题；但如果数组里有特殊字符、或者元素结构复杂，驱动返回的就是原始的PgArray对象，直接触发错误。
• Metabase的结果转换逻辑：Metabase会尝试把JDBC返回的对象转换成Clojure原生类型，但对于PgArray的处理有边缘场景覆盖不全——比如某些特定长度或元素类型的数组，转换逻辑失效，导致最终传递到序列化步骤的还是原始PgArray对象。

为什么重铸为TEXT能解决问题？ #

当你用array_to_string(your_text_array, ',')这类函数把数组重铸为普通TEXT类型时，返回的结果是Clojure原生支持的字符串类型，完全在可序列化的范围内，自然不会触发Unfreezable错误。这是最直接的临时 workaround，但确实只是绕过了问题，没有从根源解决。

额外的排查和解决方向 #

如果你想彻底解决这个问题，可以试试这些思路：

• 定位触发的特定数据：查看Metabase的报错日志，找到报错时对应的查询和数组内容，看看是不是有特定格式的数组（比如包含换行符、特殊符号）触发了问题；
• 升级JDBC驱动版本：不同版本的PostgreSQL JDBC驱动对PgArray的实现有差异，我当时升级到最新稳定版后，部分边缘场景的问题就消失了；
• 自定义类型转换：如果有能力修改Metabase代码，可以添加一个针对PgArray的自定义转换器，把它转换成Clojure的向量（比如通过PgArray.getArray()方法提取数组内容，再转成Clojure集合），这样就能让序列化逻辑正常处理了。

内容的提问来源于stack exchange，提问作者Josef Joe Samanek