LoopBack4模型异常：this.toEntities及entityClass实例化返回undefined

问题现象 #

原生SQL查询数据库能获取正常数据，但通过emissionRepository.find()返回的Emission实体所有字段均为undefined；追踪代码发现new this.entityClass(model.toObject())实例化实体后数据异常，怀疑模型配置存在问题。

排查与解决步骤 #

1. 核对模型属性与数据库字段的匹配性 #

• 字段名匹配：LoopBack默认会将模型驼峰属性名转换为下划线命名的数据库字段（反之亦然），但如果数据库字段名和模型属性名不遵循这个规则，需要在@property装饰器中显式指定数据库字段名：

  @property({
    type: 'number',
    name: 'no_of_year' // 明确指定数据库中对应的字段名
  })
  no_of_year: number
  

• 字段类型匹配：检查数据库字段类型与模型定义的type是否兼容。例如数据库中co2_actual_emission是DECIMAL类型，模型需要指定dataType来确保类型转换正确：

  @property({
    type: 'number',
    dataType: 'decimal' // 匹配数据库的DECIMAL类型
  })
  co2_actual_emission: number
  

2. 检查模型属性的可选性配置 #

当前模型中no_of_year和co2_actual_emission未设置optional: true，如果数据库中这些字段允许为空，或者查询结果中存在字段缺失的情况，实例化实体时会因必填属性未赋值而出现undefined。根据业务需求调整：

@property({
  type: 'number',
  optional: true // 允许字段为空
})
no_of_year?: number

3. 验证实体手动实例化结果 #

在测试代码中添加手动实例化逻辑，确认数据是否能正确赋值：

// 查询原始数据
const rawEmissions = await this.emissionRepository.execute(`SELECT * FROM emissions`);
console.log('原始数据库数据:', rawEmissions);

// 手动实例化实体
const testEmission = new Emission(rawEmissions[0]);
console.log('手动实例化结果:', testEmission);

如果手动实例化后字段仍为undefined，说明原始数据的字段名或类型与模型不匹配，针对性调整模型配置即可。

4. 确认模型与数据库表的关联 #

LoopBack默认将模型名转为复数小写作为表名（如Emission对应emissions表），如果数据库表名不符合这个规则，需要在@model装饰器中指定表名：

@model({ name: 'emission_table' }) // 指定实际数据库表名
export class Emission extends Entity {
  // ... 属性定义
}

5. 检查Repository的正确性 #

确认EmissionRepository正确继承DefaultCrudRepository并关联了正确的数据源与模型：

import { DefaultCrudRepository, inject } from '@loopback/repository';
import { Emission, EmissionRelations } from '../models';
import { DbDataSource } from '../datasources';

export class EmissionRepository extends DefaultCrudRepository<
  Emission,
  typeof Emission.prototype.id,
  EmissionRelations
> {
  constructor(
    @inject('datasources.db') dataSource: DbDataSource,
  ) {
    super(Emission, dataSource);
  }
}

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