使用Objection.js插入UUID数组报错：SQL语句格式异常

看起来你在尝试用Objection.js向带有UUID数组列的medias表插入数据时，遇到了SQL生成格式错误的问题。你当前的写法导致生成的SQL里出现了ARRAY [ {"_value":"BFAD6B0D-D3E6-4EB3-..."} ]这种不符合语法的内容，这是因为嵌套使用lit和castArray的方式不对，Objection没能正确解析成原生的UUID数组语法。

下面给你几种可行的解决方案：

方案1：直接使用Knex Raw构造UUID数组 #

最直接的方式是用Knex的raw方法来构造符合数据库语法的UUID数组，确保生成的SQL完全正确：

const order = [ 'BFAD6B0D-D3E6-4EB3-B3AB-108244A5DD7F' ]
// 单个UUID的场景
const uuidArrayRaw = knex.raw('ARRAY[?::uuid]', [order[0]])

await Medias
  .query()
  .insert({ order: uuidArrayRaw })

如果是多个UUID的批量场景，比如order = ['uuid1', 'uuid2', 'uuid3']，可以调整为：

const uuidPlaceholders = order.map(() => '?::uuid').join(',')
const uuidArrayRaw = knex.raw(`ARRAY[${uuidPlaceholders}]`, order)

方案2：利用Objection的cast方法简化写法 #

你也可以结合lit和cast来正确生成UUID数组，避免嵌套错误：

const order = [ 'BFAD6B0D-D3E6-4EB3-B3AB-108244A5DD7F' ]
// 用PostgreSQL数组的字符串语法{uuid1,uuid2}，再转为uuid[]类型
const arrayLiteral = lit(`{${order.join(',')}}`).castType('uuid[]')

await Medias
  .query()
  .insert({ order: arrayLiteral })

这种写法生成的SQL会是标准格式：INSERT INTO medias ("order") VALUES ('{BFAD6B0D-D3E6-4EB3-B3AB-108244A5DD7F}'::uuid[])。

方案3：自定义模型属性转换（推荐长期使用） #

如果需要频繁处理UUID数组，可以在Medias模型里添加属性转换逻辑，这样插入时直接传字符串数组即可，无需每次手动处理：

class Medias extends Model {
  // 定义列类型，让Objection自动处理转换
  static get columnTypes() {
    return {
      order: 'uuid[]'
    }
  }

  // 或者用beforeInsert钩子统一处理
  $beforeInsert() {
    if (this.order && Array.isArray(this.order)) {
      const uuidPlaceholders = this.order.map(() => '?::uuid').join(',')
      this.order = knex.raw(`ARRAY[${uuidPlaceholders}]`, this.order)
    }
  }
}

之后插入时就可以直接传字符串数组：

await Medias.query().insert({ order: [ 'BFAD6B0D-D3E6-4EB3-B3AB-108244A5DD7F' ] })

为什么你的原写法会出错？ #

你原代码里lit(order.map(id => lit(id).castType('uuid'))).castArray()的问题在于，lit接收的是字符串或SQL表达式，而你传入的是一个lit对象数组，Objection无法正确将这些对象序列化为原生SQL，所以生成了包含对象结构的错误SQL片段。

内容的提问来源于stack exchange，提问作者Robert Rossmann