Kysely项目中PostgreSQL模式创建时的日志处理技巧

在使用Kysely操作PostgreSQL数据库时，开发人员可能会遇到一个常见场景：当使用createSchema方法创建数据库模式(schema)时，如果模式已存在，PostgreSQL会输出NOTICE级别的日志。这个行为虽然无害，但在某些生产环境中可能希望抑制这类日志输出。

问题现象

通过Kysely执行以下代码时：

database.schema.createSchema('some-schema').ifNotExists().execute();

PostgreSQL会返回如下NOTICE日志：

{
  "severity_local": "NOTICE",
  "severity": "NOTICE",
  "code": "42P06",
  "message": "schema \"some-schema\" already exists, skipping",
  "file": "schemacmds.c",
  "line": "132",
  "routine": "CreateSchemaCommand"
}

问题本质

这个日志输出实际上是PostgreSQL数据库引擎本身的行为，而非Kysely框架生成的。当使用IF NOT EXISTS子句创建模式时，如果模式已存在，PostgreSQL会主动发出这个通知。

解决方案

要解决这个问题，我们需要从PostgreSQL客户端配置入手，而不是Kysely框架本身。在使用PostgreSQL的JavaScript客户端时，可以通过以下两种方式处理：

1. 完全禁用NOTICE通知：

const postgres = require('postgres')({
  onNotice: false
});

2. 自定义NOTICE处理函数（更灵活的方式）：

const postgres = require('postgres')({
  onNotice: (notice) => {
    // 可以在这里添加自定义处理逻辑
    // 例如只忽略特定类型的NOTICE
    if (notice.code !== '42P06') {
      console.log(notice);
    }
  }
});

技术背景

PostgreSQL中的NOTICE是一种特殊类型的消息，用于向客户端传递非致命性的信息。这些消息通常用于：

• 报告不影响查询执行的警告
• 提供信息性消息（如对象已存在）
• 报告配置问题或潜在问题

在PostgreSQL中，错误代码42P06对应的是"duplicate_schema"，专门用于模式已存在的情况。理解这些错误代码有助于更精确地处理不同类型的通知。

最佳实践建议

1. 开发环境：建议保留NOTICE日志，它们可能包含有价值的信息
2. 生产环境：可以考虑过滤或禁用某些NOTICE，但要注意不要忽略真正重要的警告
3. 测试环境：可以捕获并验证NOTICE，确保应用程序按预期处理各种情况