如何排查TypeORM中Unknown column 'NaN'错误的问题字段

这个错误的本质是某个实体字段的值被意外设置为NaN，导致TypeORM生成SQL时错误地将NaN当作列名处理——即便TypeORM自带日志显示的参数看似正常，也可能是参数序列化或映射环节出了问题。以下是精准定位问题的实操步骤：

1. 拦截查询参数，直接排查原始值 #

TypeORM的日志可能会对参数做格式化，无法看到真实的原始值。可以通过自定义事件订阅器，在查询执行前逐个检查参数：

import { EventSubscriber, QueryRunner, BeforeQuery } from "typeorm";

@EventSubscriber()
export class QueryDebugSubscriber {
  @BeforeQuery()
  beforeQuery(queryRunner: QueryRunner) {
    const { parameters } = queryRunner.query;
    if (!parameters) return;

    console.log("[DEBUG] Query Parameters:", parameters);
    const nanParams = parameters.filter(param => Number.isNaN(param));
    if (nanParams.length > 0) {
      console.error("[ERROR] Found NaN in parameters:", nanParams);
      // 打印调用栈，快速定位赋值源头
      console.error(new Error("NaN detected in query params").stack);
    }
  }
}

将这个订阅器注册到TypeORM的subscribers配置项中，执行报错操作后，就能直接看到哪个参数是NaN，以及对应的调用栈。

2. 检查实体字段的类型转换逻辑 #

即便表结构和实体定义看起来一致，自定义的类型转换器（Transformer）也可能在转换过程中生成NaN：

// 错误示例：转换无法解析的字符串会返回NaN
@Column({
  type: "int",
  transformer: {
    to: (val: string) => parseInt(val), 
    from: (val: number) => val.toString()
  }
})
age: number;

修复方法是在转换中加入校验：

transformer: {
  to: (val: string) => {
    const num = parseInt(val);
    if (Number.isNaN(num)) throw new Error(`Invalid value for age: ${val}`);
    return num;
  },
  from: (val: number) => val.toString()
}

3. 查看MySQL原生查询日志 #

TypeORM的日志可能无法还原发送给MySQL的真实SQL。临时开启MySQL的通用日志，直接查看执行的原始语句：

-- 临时开启全局查询日志
SET GLOBAL general_log = 'ON';
SET GLOBAL general_log_file = '/tmp/mysql_raw_queries.log';

触发报错后，打开日志文件，找到报错的SQL语句，就能直接看到NaN出现在哪个字段位置。

4. 排查业务逻辑中的赋值操作 #

检查所有给实体字段赋值的业务代码，是否存在产生NaN的计算：

• 除以0的运算：entity.rate = 100 / 0
• 无效的数值转换：entity.amount = parseFloat("abc")
• 非法的数学运算：entity.sqrtVal = Math.sqrt(-1)

可以给实体字段添加setter校验，提前拦截NaN赋值：

class Order {
  private _amount: number;

  @Column({ type: "decimal" })
  get amount(): number {
    return this._amount;
  }

  set amount(val: number) {
    if (Number.isNaN(val)) {
      throw new Error(`Attempt to assign NaN to Order.amount, value: ${val}`);
    }
    this._amount = val;
  }
}

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