.NET Core 请求匹配重复端点（AmbiguousMatchException）问题咨询

遇到这种看似矛盾的错误——明明只有一个GetShipTo方法，却提示重复匹配同一端点，大概率是程序集加载、编译缓存或路由配置的隐性问题，以下是具体排查和解决思路：

常见原因及解决办法 #

• 程序集重复加载/残留
  检查项目的bin/obj目录，或者部署环境的目标目录，是否存在多个版本的Sage100_API.dll（比如旧编译文件没清理）。路由系统会加载所有找到的控制器类型，重复的程序集会导致同一个控制器类被注册两次。解决办法：彻底清理bin/obj，重新编译发布；部署时先清空目标目录再复制新文件。

• 控制器服务重复注册
  检查Program.cs（.NET 6+）或Startup.cs（.NET 5）中的服务配置，是否多次调用了AddControllers()、AddMvc()这类会注册控制器的方法。重复注册会导致路由系统重复扫描控制器，进而重复注册端点。

• 路由特性冲突或重复定义
  仔细检查GetShipTo方法上的路由特性：

  • 有没有同时使用[Route]和[HttpGet]且路由模板重复？比如[Route("api/ship-to")]和[HttpGet("api/ship-to")]会导致同一个路由被注册两次。
  • 即使只有一个方法，也可能因为特性配置问题让路由系统生成重复的端点。可以尝试给方法指定唯一的路由名称和明确的模板，比如：

    [HttpGet("api/ship-to", Name = "Unique_GetShipTo")]
    public IActionResult GetShipTo()
    {
        // 方法逻辑
    }
    

• 编译缓存或IDE问题
  有时候IDE的编译缓存会导致异常，试试重启IDE，或者用命令行执行dotnet clean && dotnet build重新编译项目。

排查辅助手段 #

可以添加一个临时的路由调试接口，查看所有注册的路由端点，确认是否真的存在重复条目：

// 在Program.cs的UseEndpoints配置中添加
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
    
    // 临时调试路由
    endpoints.MapGet("/debug-routes", async context =>
    {
        var dataSource = endpoints.DataSources.OfType<ControllerActionEndpointDataSource>().FirstOrDefault();
        if (dataSource == null)
        {
            await context.Response.WriteAsync("No controller routes found");
            return;
        }
        
        var routes = dataSource.Endpoints
            .Select(e => new 
            {
                Route = ((RouteEndpoint)e).RoutePattern.RawText,
                Action = ((ControllerActionDescriptor)e.Metadata.GetMetadata<ControllerActionDescriptor>()).DisplayName
            });
        
        await context.Response.WriteAsJsonAsync(routes);
    });
});

启动项目后访问/debug-routes，就能看到所有注册的路由和对应的控制器方法，直接定位重复的条目。

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