NestJS中实体转DTO报错：TypeError无法读取undefined的name属性

错误原因 #

报错TypeError: Cannot read properties of undefined (reading 'name')的核心原因是DTO的职责混淆：

• 你定义的BaseCategoryDto同时承担了「请求输入验证」和「实体转响应DTO」两个职责，并且它的构造函数依赖Categories实体对象。
• 当NestJS的ValidationPipe处理POST请求体时，会通过class-transformer的plainToInstance方法把请求的普通JSON对象转换为CreateCategoryDto实例。这个过程是无参构造实例后再赋值属性，不会调用你定义的带Categories参数的构造函数，导致BaseCategoryDto构造函数里的category参数为undefined，访问category.name时触发报错。

解决方案 #

最规范的做法是拆分输入DTO与响应DTO，彻底分离验证逻辑和实体转换逻辑：

1. 重构输入DTO（用于请求验证） #

创建仅负责输入验证的基础DTO，不带依赖实体的构造函数：

import { IsNotEmpty, Optional } from 'class-validator';
import { PartialType } from '@nestjs/mapped-types';

// 基础输入DTO，仅做字段验证
export class BaseCategoryInputDto {
  @IsNotEmpty()
  name: string;

  @Optional()
  description: string;
}

// 创建分类的输入DTO
export class CreateCategoryDto extends BaseCategoryInputDto {}

// 更新分类的输入DTO（按需扩展）
export class UpdateCategoryDto extends PartialType(BaseCategoryInputDto) {}

2. 重构响应DTO（用于实体转换） #

创建专门负责将Categories实体转换为响应格式的DTO：

// 基础响应DTO
export class BaseCategoryResponseDto {
  name: string;
  description: string;

  constructor(category: Categories) {
    this.name = category.name;
    this.description = category.description;
  }
}

// 完整分类响应DTO
export class CategoryDto extends BaseCategoryResponseDto {
  id: string;

  constructor(category: Categories) {
    super(category);
    this.id = category.id;
  }
}

3. 修改服务层代码 #

将服务层的返回类型改为新的CategoryDto：

// CategoriesService
async createCategory(
  createCategoryDto: CreateCategoryDto,
): Promise<CategoryDto> {
  const newCategory = await this._categoryRepository.createCategory(createCategoryDto);
  return new CategoryDto(newCategory);
}

4. 修改控制器代码 #

同步控制器的返回类型：

// CategoriesController
@Post()
async createCategory(
  @Body() createCategoryDto: CreateCategoryDto,
): Promise<CategoryDto> {
  return await this._categoryService.createCategory(createCategoryDto);
}

备选快速修复方案（不推荐长期使用） #

如果不想拆分DTO，可以修改BaseCategoryDto的构造函数，兼容无参实例化的场景：

export class BaseCategoryDto {
  @IsNotEmpty()
  name: string;
  @Optional()
  description: string;

  // 允许参数为undefined或Partial<Categories>
  constructor(category?: Partial<Categories>) {
    if (category) {
      this.name = category.name;
      this.description = category.description;
    }
  }
}

这种方式可以临时解决报错，但会让DTO的职责依然模糊，不利于后续维护。

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