使用tsoa搭配Express生成Swagger时遇类型解析错误求助

• 修正HTTP方法与操作的匹配：你用@Get('/')处理创建笔记的逻辑，但GET请求规范上不携带请求体，tsoa解析时可能因此触发类型异常。创建资源请改用@Post('/')注解。
• 给控制器方法添加明确名称：匿名方法会导致tsoa无法生成正确的元数据，给异步方法命名，示例：

  @Post('/')
  public async createNote(req: Request, res: Response, _next: NextFunction): Promise<any> {
      // 原有逻辑代码
  }
  

• 检查类型导入与定义：
  • 确认Request、Response、NextFunction从express正确导入：import { Request, Response, NextFunction } from 'express';
  • 确保CreateNote类型已正确定义并导出，比如：

    export interface CreateNote {
      title: string;
      content: string;
      // 其他字段
    }
    

• 验证tsoa配置：检查tsoa.json配置文件，确认entryFile指向控制器入口文件，spec输出路径正确；同时确保tsconfig.json启用了emitDecoratorMetadata: true、experimentalDecorators: true这两个必要选项。
• 清理缓存后重新生成：删除之前生成的swagger文件和tsoa缓存，再重新执行tsoa spec命令，避免缓存干扰解析。

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