Prisma Client Go 中不区分大小写查询的实现与问题解析

背景介绍

在使用 Prisma Client Go 进行数据库查询时，开发者经常会遇到需要实现不区分大小写(Case Insensitive)查询的需求。特别是在使用 PostgreSQL 数据库时，这种需求更为常见。本文将深入探讨在 Prisma Client Go 中实现不区分大小写查询的正确方法，以及可能遇到的问题和解决方案。

正确实现不区分大小写查询

在 Prisma Client Go 中，要实现不区分大小写的查询，需要使用 QueryModeInsensitive 模式。正确的实现方式应该是将查询条件和模式设置放在同一个查询对象中：

db.Product.And(
    db.Product.Name.Contains(searchTerm),
    db.Product.Name.Mode(db.QueryModeInsensitive),
)

这种写法会生成符合预期的查询语句：

{
  "where": {
    "AND": [
      {
        "name": {
          "mode": "insensitive",
          "contains": "searchTerm"
        }
      }
    ]
  }
}

常见错误实现方式

许多开发者容易犯的错误是将查询条件和模式设置分开在不同的查询对象中：

// 错误的写法
db.Product.Or(
    db.Product.And(
        db.Product.Name.Contains(searchTerm),
    ),
    db.Product.And(
        db.Product.Name.Mode(db.QueryModeInsensitive),
    ),
)

这种写法会生成无效的查询语句，因为模式设置没有与查询条件关联在一起：

{
  "where": {
    "OR": [
      {
        "AND": [
          {
            "name": {
              "mode": "insensitive"
            }
          }
        ]
      },
      {
        "AND": [
          {
            "name": {
              "contains": "searchTerm"
            }
          }
        ]
      }
    ]
  }
}

重复执行查询时的问题

开发者还发现了一个有趣的问题：当重复执行相同的查询时，可能会遇到"重复字段"的错误。这是因为 Prisma Client Go 的内部实现中，buildFields 函数在处理字段时会保留之前查询的状态。

例如以下代码会在第二次执行时出错：

where := []db.ProductWhereParam{
    db.Product.Name.Contains("prisMA"),
    db.Product.Name.Mode(db.QueryModeInsensitive),
}

query := r.client.Product.FindMany(where...)
_, err := query.Exec(context.Background()) // 第一次执行成功
_, err = query.Exec(context.Background())  // 第二次执行会报错

解决方案

对于重复查询的问题，目前有两种解决方案：

1. 创建新的查询对象：每次执行时都创建一个新的查询对象

query1 := r.client.Product.FindMany(where...)
query2 := r.client.Product.FindMany(where...)

2. 修改内部实现：调整 buildFields 函数的实现，避免保留之前查询的状态

技术原理深入

Prisma Client Go 在构建查询时，会检查字段是否重复。对于模式设置(mode)这样的特殊字段，目前的实现可能会导致在重复查询时出现误判。这是因为：

1. 查询构建器会跟踪已处理的字段
2. 重复执行相同的查询时，之前的状态可能没有被正确清除
3. 模式设置被视为普通字段参与重复检查

最佳实践建议

1. 始终将查询条件和模式设置放在同一个查询对象中
2. 避免重复使用同一个查询对象执行多次查询
3. 对于需要分页的场景，考虑单独计算总数而不是复用查询对象
4. 关注 Prisma Client Go 的更新，这个问题可能会在后续版本中得到修复

通过理解这些原理和最佳实践，开发者可以更有效地在 Prisma Client Go 中实现不区分大小写的查询功能，避免常见的陷阱和错误。