TypeScript类型安全疑问：字符串传入数字参数是否为设计如此？

作为从Java转TypeScript/NestJS的开发者，你遇到的这个问题确实很容易让人困惑，咱们一步步拆解清楚：

问题根源：编译时类型检查 vs 运行时实际类型 #

首先要明确两个核心点：

1. HTTP请求的Query参数本质都是字符串：不管前端传的是数字还是其他类型，HTTP协议里Query参数都是以字符串形式传递的，NestJS默认不会自动帮你转换类型。
2. TypeScript是编译时类型检查：它只在代码编译阶段做类型验证，运行时没有任何类型信息——也就是说，编译通过不代表运行时类型一定符合预期。

你代码里的@Query()没有指定任何类型，所以TypeScript会把query推断为any类型。any类型是TypeScript的“逃逸舱”，它会绕过所有类型检查：当你把query.page（any类型）传给期望number类型的参数时，TypeScript不会报错，但运行时实际传入的还是HTTP传来的字符串。

而如果直接写this.cache.getProxyCache("1", "4")，TypeScript会直接检测到字符串和number类型不匹配，所以会报错——这就是两种传参方式的区别。

这是设计特性还是Bug？ #

这既不是Bug，也不是TypeScript的限制，而是TypeScript类型系统结合NestJS默认行为的正常特性：

• TypeScript的any类型就是用来兼容动态场景的，当你没有给变量指定明确类型时，它会默认用any，自然不会做类型检查。
• NestJS默认不自动转换Query参数类型，是因为HTTP参数的类型转换需要考虑很多场景（比如空值、非法格式），框架把控制权交给开发者更灵活。

解决方案：让类型安全贯穿编译和运行时 #

要解决这个问题，咱们需要同时做两件事：编译时的类型约束和运行时的类型转换与验证，NestJS提供了两种简洁的方式：

方式1：直接用ParseIntPipe转换单个参数 #

如果你只需要处理分页参数，可以直接给@Query加上ParseIntPipe，它会自动把字符串转成数字，并且如果参数不是合法数字会抛出错误：

import { ParseIntPipe } from '@nestjs/common';

async findAll(
  @Query('page', ParseIntPipe) page: number = 0,
  @Query('page_size', ParseIntPipe) pageSize: number,
  @Res() res: Response
) {
  // 这里page和pageSize已经是number类型了，编译和运行时都安全
  await this.cache.getProxyCache(page, pageSize);
}

方式2：用DTO+ValidationPipe做完整验证 #

如果参数更多或者需要复杂验证，可以定义一个DTO（数据传输对象），配合class-validator和class-transformer实现自动转换与验证：

1. 先安装依赖：

npm install class-validator class-transformer

2. 定义DTO类：

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

export class PaginationQueryDto {
  @IsInt() // 验证必须是整数
  @Min(0) // 验证最小值为0
  @Transform(({ value }) => parseInt(value, 10)) // 把字符串转成数字
  page: number = 0;

  @IsInt()
  @Min(1) // 每页大小至少为1
  @Transform(({ value }) => parseInt(value, 10))
  page_size: number;
}

3. 在控制器里使用：

import { ValidationPipe } from '@nestjs/common';

async findAll(
  @Query(new ValidationPipe({ transform: true })) query: PaginationQueryDto,
  @Res() res: Response
) {
  // 此时query的page和page_size已经是number类型，且通过了验证
  await this.cache.getProxyCache(query.page, query.page_size);
}

这样处理后，不管是编译时的类型提示，还是运行时的参数转换与验证，都能保证类型安全，再也不会出现字符串和数字混用的问题了。

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