导入Swagger至Azure APIM遭遇重复签名错误，请求技术支持

听起来你遇到的问题挺棘手的——之前能正常导入的Swagger，在2018年5月APIM更新后突然报重复签名错误，而且你自己检查路由也没发现问题。结合你给出的端点代码和错误提示，我来梳理几个可能的原因和解决方向：

1. 先确认Swagger文档本身是否真的存在重复操作 #

有时候代码里的路由看起来没问题，但Swagger生成器可能因为某些细节生成了重复的路径定义。你可以：

• 导出Swagger的JSON/YAML文件，直接搜索错误提示里的路径（比如GET /api/v1/brokers/{brokerid}），看是否真的出现了两次。
• 打开Swagger UI，逐个检查这些路径下的GET操作，是否有两个完全相同的条目，或者参数定义有细微差异但路径一致的情况。

2. 排查Swagger生成时的OperationId问题 #

APIM在计算操作签名时，可能会参考Swagger里的operationId字段。如果你的代码没有明确指定唯一的operationId，Swagger生成器可能会自动生成重复的ID（比如不同控制器里的同名方法，生成的ID可能冲突）。

解决方法：在每个API方法上添加[SwaggerOperation]属性，手动指定唯一的OperationId，比如：

[Route("{officeId:int:min(1)}", Name = "GetOfficeById")]
[SwaggerOperation(OperationId = "GetOfficeById_V1")]
public IHttpActionResult GetOfficeById(int officeId, [FromUri] IncludeImageModel includeImage)

确保每个操作的OperationId完全唯一，再重新生成Swagger导入试试。

3. 检查路由参数的大小写或命名一致性 #

看你的错误提示里路径参数是小写的{brokerid}，但代码里是驼峰式的{brokerId}。2018年5月的APIM更新可能调整了路径参数的大小写敏感性，导致原本被视为相同的参数现在被区分开，或者反过来——原本不同的参数被视为相同？

你可以：

• 检查Swagger生成的文档里，路径参数的名称是brokerid还是brokerId，确保和代码里的定义一致。
• 如果是大小写问题，统一代码里的路由参数命名和Swagger里的定义，或者手动修改Swagger文件里的参数名称，保持一致后再导入。

4. 确认控制器的路由前缀是否正确 #

你的端点用的是相对路由（比如[Route("{officeId:int:min(1)}")]），这意味着每个控制器必须有正确的路由前缀，比如：

[RoutePrefix("api/v1/offices")]
public class OfficesController : ApiController
{
    // 你的GetOfficeById方法
}

如果多个控制器用了相同的路由前缀，就会导致生成的路径重复。比如如果BrokersController也用了api/v1/offices作为前缀，那它的{brokerId}路由就会和OfficesController的路径冲突。

5. 尝试手动修改Swagger文件绕过APIM的签名检查 #

如果以上方法都无效，你可以手动编辑Swagger文件，给重复的操作添加不同的operationId，或者给路径添加一个微小的差异（比如给其中一个路径加个查询参数占位符），然后再导入APIM。虽然这是个临时方案，但能帮助你确认是否是APIM的解析逻辑导致的问题。

最后，记得在导入前清理APIM里已有的相关API定义，避免残留的旧定义干扰。

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