Postgres.js中JSON处理导致的"cannot deconstruct a scalar"错误解析

问题背景

在使用Postgres.js库操作PostgreSQL数据库时，开发者在执行一个保存系统密钥的函数时遇到了"cannot deconstruct a scalar"错误。这个函数尝试将键值对形式的密钥数据加密后存储到数据库中，当使用Postgres.js的rawSQL方法时会报错，但同样的SQL语句通过Prisma的$queryRaw却能正常工作。

错误分析

错误信息显示这是一个PostgreSQL错误，代码为22023，发生在jsonfuncs.c文件的2178行，具体在each_scalar例程中。这表明问题出在JSON数据的处理上。

核心问题在于Postgres.js对JSON类型参数的特殊处理机制。当开发者使用::json类型转换时，Postgres.js会自动对参数进行JSON.stringify处理。而开发者又手动调用了JSON.stringify，导致双重字符串化，最终PostgreSQL无法正确解析这个JSON数据。

解决方案

正确的做法是：

1. 移除手动JSON.stringify调用
2. 让Postgres.js自动处理JSON类型的转换

修改后的代码应该是：

export function saveSystemSecrets(
  secrets: Record<string, string | number | boolean>
) {
  return rawSQL`
      WITH "NewSecrets" AS (SELECT "key", PGP_SYM_ENCRYPT("value", ${process.env.SYSTEM_ENCRYPTION_KEY || ""}::text) AS "secret"
                            FROM JSON_EACH_TEXT(${secrets}::json)),
           "UpdatedSecrets" AS (
      INSERT
      INTO "SystemSecrets" ("key", "secret", "createdAt", "updatedAt")
      SELECT "key", "secret", now(), now()
      FROM "NewSecrets" ON CONFLICT ("key") DO
      UPDATE SET "secret" = EXCLUDED."secret", "updatedAt" = now()
          RETURNING "key", "secret"
          )
      DELETE
      FROM "SystemSecrets"
      WHERE "key" NOT IN (SELECT "key" FROM "NewSecrets");
  `;
}

技术原理

Postgres.js在设计上对常见数据类型做了智能处理：

1. 当检测到参数被标记为::json类型时，会自动进行JSON序列化
2. 这种设计可以减少开发者的手动处理工作
3. 但同时也可能导致开发者无意中重复处理数据

相比之下，Prisma的$queryRaw方法采用了不同的参数处理策略，它不会自动进行JSON序列化，因此原始代码能够正常工作。

最佳实践建议

1. 在使用Postgres.js时，避免手动处理已经被库自动处理的数据类型
2. 对于JSON数据，直接传递对象而不要预先序列化
3. 了解所用ORM/查询构建器的参数处理机制
4. 在遇到类似错误时，检查是否存在数据类型处理的重复或冲突

通过理解这些底层机制，开发者可以更高效地使用Postgres.js并避免类似的数据处理问题。