#2198·swag

v2: 当一个处理器在多行 @Router 中被记录时,没有防止重复的 operationId

作者: ahridin创建于 2026年7月14日更新于 2026年7月14日

**swag 版本:** v2.0.0-rc5 当一个共享的 Go 处理函数被用于文档中超过一个 `@Router` 注解(例如,同一个处理函数同时服务于当前路由和传统/版本化路由)时,swag 会从函数名称中提取 `operationId`,生成两个具有相同 `operationId` 的操作。OpenAPI 要求 `operationId` 在整个文档中必须是唯一的,因此这是一个规范违规,某些代码生成工具会默默地将一个操作的生成的客户端方法覆盖为另一个操作的生成的客户端方法。