MikroORM中JSON嵌入类型数字属性过滤问题解析

问题背景

在使用MikroORM进行数据库操作时，开发者发现当对JSON嵌入类型(Embeddable)中的数字类型属性进行过滤查询时，会出现类型转换问题。具体表现为：当尝试使用$gt等比较操作符对嵌入对象的数字属性进行过滤时，系统没有正确地将存储的JSON字符串值转换为数字类型，而是直接进行了文本与数字的比较。

问题复现

典型的问题场景如下定义：

@Embeddable()
export class MyEmbeddable {
  @Property({ type: 'double' })
  numberProperty: number;
}

@Entity()
export class MyEntity {
  @Embedded({ object: true })
  myEmbeddable: MyEmbeddable;
}

当执行如下查询时出现问题：

{ myEmbeddable: { numberProperty: { $gt: 100 } } }

问题原因

经过分析，问题的根源在于对嵌入类型中的数字属性错误地使用了type: 'double'类型声明。在JSON嵌入类型的场景下，MikroORM会将整个对象序列化为JSON字符串存储在数据库中，而JSON本身已经包含了值的类型信息（数字会被存储为数字类型，而非字符串）。

当开发者显式指定type: 'double'时，MikroORM会尝试对这个JSON中的值进行额外的类型转换，但实际上JSON.parse()已经能够正确识别数字类型，这导致了双重类型转换的问题。

解决方案

正确的做法是省略type: 'double'声明，让MikroORM依赖JSON本身的类型系统：

@Embeddable()
export class MyEmbeddable {
  @Property()  // 移除了type声明
  numberProperty: number;
}

技术原理

1. JSON存储机制：当使用@Embedded({ object: true })时，MikroORM会将整个对象序列化为JSON字符串存储在数据库中。JSON规范明确区分了数字和字符串类型。

2. 类型转换流程：在查询时，MikroORM会：

   • 从数据库读取JSON字符串
   • 使用JSON.parse()解析为JavaScript对象
   • 对解析后的值应用过滤条件

3. 类型声明冲突：额外的type: 'double'声明干扰了这个自然转换流程，导致系统尝试对已经是数字的值再次进行转换。

最佳实践

1. 对于JSON嵌入类型中的基本类型属性，通常不需要显式指定数据库类型
2. 仅在需要特殊处理时才使用@Property的类型声明
3. 对于复杂查询场景，建议先验证查询条件的类型转换行为

总结

这个问题展示了在使用ORM时理解底层数据存储机制的重要性。在JSON嵌入类型场景下，开发者应该信任JSON本身的类型系统，避免不必要的类型声明，这样才能确保查询过滤等操作的正确性。MikroORM团队已经确认这是预期行为，移除非必要的类型声明即可解决问题。