NestJS开启TypeScript strict模式时实体字段的正确赋值方式

在启用TypeScript的"strict": true配置后，TypeORM实体类的属性会因为TypeScript无法感知到ORM框架会自动初始化这些属性而抛出Property has no initializer and is not definitely assigned in the constructor错误。针对这个问题，推荐以下规范做法：

推荐方案：使用非空断言（!） #

直接在属性后添加非空断言符号，明确告诉TypeScript：该属性一定会在实例使用前被赋值（由TypeORM从数据库映射或生成）。这是社区最常用的方案，既符合代码逻辑，又不会产生误导。

修改后的实体代码：

import { Column, Entity, PrimaryGeneratedColumn } from 'typeorm';
import { OrganizationTypeEnum } from './organization-type.enum';

@Entity({ name: 'Organization' })
export class OrganizationEntity {
  @PrimaryGeneratedColumn('uuid')
  id!: string;

  @Column()
  name!: string;

  @Column({ default: null })
  logoUrl: string | null;

  @Column({ default: OrganizationTypeEnum.COBRAND })
  type!: OrganizationTypeEnum;
}

注：logoUrl因为已经显式声明为string | null且配置了default: null，TypeScript能识别它的合法性，因此不需要非空断言。

不推荐的方案分析 #

• 直接赋值默认值（如id: string = ''）：这种方式不符合业务逻辑——id是数据库生成的UUID，空字符串并非其真实初始值，会误导后续开发者，甚至可能引发依赖id有效性的逻辑错误。
• 全局关闭strictPropertyInitialization：在tsconfig.json中单独设置"strictPropertyInitialization": false可以规避报错，但这会禁用所有类的属性初始化检查，可能漏掉其他类的真实初始化问题，牺牲了strict模式的严谨性。

关于Strict模式的价值 #

完全值得坚持启用"strict": true配置。它能在编译阶段提前捕获大量类型错误、未初始化变量等问题，大幅降低运行时bug的概率，同时提升代码的可读性和可维护性。NestJS作为TypeScript优先的框架，本身就适配strict模式，只需针对ORM实体这类特殊场景做少量适配即可。

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