为何接口返回的整数ID被序列化为字符串？

结论 #

这不属于正常规范，是你的操作环节存在疏漏——TypeScript接口仅做编译时类型检查，不会自动处理运行时的类型转换；Swagger文档只是基于类型注解生成的描述，不负责实际序列化时的类型校正。

问题原因 #

• TypeScript的接口是编译时类型，编译后会被完全移除，运行时没有任何类型约束作用。如果你的数据源（比如数据库查询结果、第三方API响应、前端请求参数）返回的id原本就是字符串类型，代码里又没有做转换，序列化后自然会保留字符串格式。
• Swagger文档生成工具是基于JSDoc和TypeScript接口的静态信息生成文档，仅用来描述预期的接口类型，不会干预运行时的数据处理流程。

解决办法 #

1. 手动显式类型转换 #

在返回DTO之前，对id进行类型转换：

// 假设你从数据源获取到原始数据
const rawTopic = { id: "1", name: "Science" };
// 转换id为数字
const formattedTopic = {
  ...rawTopic,
  id: parseInt(rawTopic.id, 10) // 或者用 Number(rawTopic.id)
};
// 此时序列化formattedTopic，id就是整数类型

2. 使用类校验与转换库 #

用class-validator + class-transformer组合，通过类代替接口（类支持运行时反射），自动处理类型转换和校验：

import { IsInt } from 'class-validator';
import { Transform, plainToInstance } from 'class-transformer';

class Topic {
  @IsInt()
  // 自动把输入的字符串转为数字
  @Transform(({ value }) => parseInt(value, 10), { toClassOnly: true })
  id: number;

  name: string;
}

// 转换原始数据并校验
const rawData = { id: "1", name: "Science" };
const validatedTopic = plainToInstance(Topic, rawData);
// validatedTopic.id 此时为数字类型1

3. 检查数据源配置 #

排查数据来源的配置：

• 如果是数据库驱动，确认是否开启了自动把数字类型转为字符串的选项（比如某些MySQL驱动在特定配置下会把INT类型转成字符串），调整配置让其返回原始数字类型。
• 如果是前端请求参数，确认是否因为URL参数解析（比如req.query默认是字符串）导致，此时可以在参数解析阶段就进行类型转换。

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