使用Mikro-ORM+MongoDB时数组变更未被检测及插入失败的解决方法

问题原因 #

Mikro-ORM的变更检测依赖属性引用的变化，直接对数组执行push/pop等原地修改操作时，数组本身的引用没有改变，ORM无法感知到字段已更新，因此不会生成数组的更新语句。

解决方案 #

提供三种可行的解决方式，按需选择：

1. 替换数组引用（推荐，符合ORM变更检测逻辑）

通过扩展运算符、concat等方式生成新数组，替换原数组的引用，触发变更检测：

export async function appendNumber() {
    const em = await getEntityManager()
    let modifyExample = await em.findOne(ProblemExample, {_id: new ObjectId("645df88643fffa295e0421ff")})

    if (!modifyExample) { return }
    modifyExample.name += "modified"
    // 生成新数组替换原引用
    modifyExample.objectArray = [...modifyExample.objectArray, {text: "new Object"}]
    modifyExample.selectedNumbers = [...modifyExample.selectedNumbers, randomInt(100)]

    await em.flush()
}

2. 手动标记字段为脏

使用Mikro-ORM提供的wrap工具，手动将数组字段标记为已修改：

import { wrap } from '@mikro-orm/core';

export async function appendNumber() {
    const em = await getEntityManager()
    let modifyExample = await em.findOne(ProblemExample, {_id: new ObjectId("645df88643fffa295e0421ff")})

    if (!modifyExample) { return }
    modifyExample.name += "modified"
    modifyExample.objectArray.push({text: "new Object"})
    modifyExample.selectedNumbers.push(randomInt(100))

    // 手动标记字段为脏
    wrap(modifyExample).markDirty('objectArray');
    wrap(modifyExample).markDirty('selectedNumbers');

    await em.flush()
}

3. 使用MongoDB原生$push操作符

直接通过nativeUpdate执行MongoDB的原生更新操作，绕过ORM的变更检测：

export async function appendNumber() {
    const em = await getEntityManager()
    const targetId = new ObjectId("645df88643fffa295e0421ff")
    let modifyExample = await em.findOne(ProblemExample, {_id: targetId})

    if (!modifyExample) { return }
    // 先更新name字段（可选，也可以合并到nativeUpdate中）
    modifyExample.name += "modified"
    await em.flush()

    // 执行原生$push更新数组
    await em.nativeUpdate(ProblemExample, {_id: targetId}, {
        $push: {
            objectArray: {text: "new Object"},
            selectedNumbers: randomInt(100)
        }
    })
}

额外说明 #

对于对象数组（objectArray），如果后续需要修改数组内的对象属性，同样需要注意：要么修改后替换整个数组引用，要么手动标记数组为脏，或者使用MongoDB的原生操作符（如$set指定数组下标）。

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