Tsoa报错：无法解析方法装饰器调用签名，参数不匹配

这个错误的核心问题在于路径参数语法错误，结合TypeScript配置或版本兼容问题导致，以下是具体修复方案：

1. 修正路径参数语法 #

Tsoa的路径参数语法要求使用冒号 : 而非大括号 {}，这是引发参数不匹配的直接原因。将错误的路径写法修改为标准格式：

// 错误写法
// @Get('{id}')
// 正确写法
@Get(':id')
public async getUser(@Path() id: number): Promise<UserAttributes | null> {
  return new UserService().getUser(id);
}

2. 检查TypeScript配置 #

确保tsconfig.json中启用装饰器相关配置：

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

3. 核对Tsoa版本兼容性 #

如果你使用的是Tsoa v3+，装饰器签名有更新，需确保代码与当前版本匹配：

• v3+ 中@Path装饰器无需额外参数，路径参数已通过@Get(':id')中的:id声明
• 确保@tsoa/runtime与tsoa版本完全一致，避免依赖不兼容

4. 其他排查点 #

• 删除node_modules和dist目录，重新执行npm install和编译命令，清理缓存依赖
• 确认所有装饰器（@Get/@Post/@Body/@Path）均正确导入自tsoa包

修正后的完整代码 #

@Get('/')
public async getAllUsers(): Promise<UserAttributes[]> {
  return new UserService().getAllUsers();
}

@Post('/')
public async createUser(@Body() body: CreateUserDto): Promise<UserAttributes> {
  return new UserService().createUser(body);
}

@Get(':id')
public async getUser(@Path() id: number): Promise<UserAttributes | null> {
  return new UserService().getUser(id);
}

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