NestJS接口返回空对象：日志有数据但接口无响应内容

在NestJS应用中用PostgreSQL+TypeORM实现商店列表分页功能，原本直接返回商店数组一切正常。后来为了让前端知晓可请求的最大页码，改成返回包含totalPages和stores的对象时，接口突然返回空响应。诡异的是，代码里console.log({totalPages, stores})能正常打印出完整数据（比如{totalPages: 1, stores: [...所有商店数据]}），但return这个对象后，Postman收到的却是空内容。

相关代码：

if (!perPage || perPage < 1) {
  perPage = 100;
}

const count = await this.repo.count();
const totalPages = Math.ceil(count / perPage);

// pageNumber 默认设为1
if (!pageNumber || pageNumber < 1) {
  pageNumber = 1;
}
// 如果页码超过最大可能值，设为最大页码
if (pageNumber > totalPages) {
  pageNumber = totalPages;
}

// 计算需要跳过的行数
const skip = (pageNumber - 1) * perPage;
const stores = await this.repo.find({
  order: { createdAt: 'ASC' },
  take: perPage,
  skip
});
console.log({ totalPages, stores }); // 这里能正常打印完整数据
return { totalPages, stores }; // Postman却收到空响应

核心原因：TypeORM实体实例的序列化问题 #

TypeORM的find方法返回的是实体类的实例对象，不是普通JSON对象，这些实例带有TypeORM的内部元数据。NestJS默认用ClassSerializerInterceptor处理响应序列化，当你把实体实例放到自定义对象（比如{totalPages, stores}）中返回时，如果实体类没有配置正确的序列化规则，拦截器会过滤掉所有属性，导致最终返回空内容。

解决办法1：手动将实体转为普通JSON对象 #

在返回前，把每个商店实体实例转成普通对象，最简单的方式是调用实体的toJSON()方法：

// 替换原来的return语句
return {
  totalPages,
  stores: stores.map(store => store.toJSON())
};

解决办法2：配置全局序列化拦截器+实体类装饰器 #

1. 在根模块（比如AppModule）中启用全局序列化拦截器：

import { Module } from '@nestjs/common';
import { APP_INTERCEPTOR } from '@nestjs/core';
import { ClassSerializerInterceptor } from '@nestjs/common';

@Module({
  providers: [
    {
      provide: APP_INTERCEPTOR,
      useClass: ClassSerializerInterceptor,
    },
  ],
})
export class AppModule {}

2. 在你的Store实体类中，给需要返回前端的属性加上@Expose装饰器：

import { Entity, Column, PrimaryGeneratedColumn } from 'typeorm';
import { Expose } from 'class-transformer';

@Entity()
export class Store {
  @PrimaryGeneratedColumn()
  @Expose()
  id: number;

  @Column()
  @Expose()
  name: string;

  @Column()
  @Expose()
  createdAt: Date;

  // 其他需要返回的属性都加上@Expose
}

这样NestJS就能正确识别并序列化实体属性，即使放在自定义对象中返回也能正常输出。

解决办法3：检查控制器是否用了@Res()装饰器 #

如果你的控制器方法用了@Res()手动处理响应，那必须手动发送响应内容，不能直接返回对象：

// 错误写法
@Get()
async getStores(@Res() res) {
  // ...你的代码
  return { totalPages, stores }; // 会导致空响应
}

// 正确写法
@Get()
async getStores(@Res() res) {
  // ...你的代码
  res.send({ totalPages, stores }); // 手动发送响应
}

如果不需要手动处理响应，建议去掉@Res()装饰器，让NestJS自动处理序列化。

额外优化：用findAndCount简化代码 #

可以不用分开调用count()和find()，用TypeORM的findAndCount方法一次获取数据和总数，代码更简洁：

const [stores, count] = await this.repo.findAndCount({
  order: { createdAt: 'ASC' },
  take: perPage,
  skip
});
const totalPages = Math.ceil(count / perPage);
// 记得结合上面的序列化处理方式返回
return { totalPages, stores: stores.map(s => s.toJSON()) };

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