控制器路由无法正常触发问题排查求助

核心问题 #

你的控制器方法路由定义要求uid作为URL路径参数（/{uid}），但页面生成的URL却将uid放在了查询字符串中（?uid=xxx），二者规则不匹配，因此无法触发目标方法。

修复方案 #

方案1：直接使用asp-route-*生成正确路径参数（推荐） #

不需要自定义ToRouteData扩展方法，ASP.NET Core Tag Helper支持直接指定路由参数，修改页面链接代码如下：

<a asp-controller="SecureAPI" 
   asp-action="SetOrderAsProcessedAsync" 
   asp-route-uid="@Model.Order.UId" 
   class="btn-antan action flex-center-center">
    <icon awesome="Lock" />&nbsp;Set as processed
</a>

生成的URL会变为：

http://localhost:5294/SecureAPI/SetOrderAsProcessedAsync/f345f4d2-b184-4652-bd1b-78cc2f28aaff

完全匹配控制器的路由规则，就能正常触发方法。

方案2：若需保留asp-all-route-data，修复扩展方法与路由识别 #

如果必须使用asp-all-route-data，需确保扩展方法返回的字典值类型正确，且ASP.NET Core能将其识别为路由参数：

1. 调整ToRouteData方法，确保Guid转为标准字符串格式：

public static IDictionary<string, string> ToRouteData(this object obj)
{
    IDictionary<string, string> result = new Dictionary<string, string>();

    foreach (IObjectPropertyModel prop in obj.GetProperties())
    {
        // 确保Guid转为标准的字符串格式
        string value = prop.Value switch
        {
            Guid guid => guid.ToString("D"),
            _ => prop.Value?.ToString() ?? string.Empty
        };
        result.Add(prop.Name, value);
    }

    return result;
}

2. 同时检查控制器类是否有路由前缀：如果控制器上标记了[Route("api/[controller]")]，则方法路由会拼接为api/SecureAPI/SetOrderAsProcessedAsync/{uid}，此时页面链接需生成对应前缀的URL。

额外检查点 #

• 验证Guid参数格式：确保生成的UID是有效的Guid字符串，避免因格式错误导致路由匹配失败。
• 确认HTTP方法匹配：如果控制器方法有[HttpPost]等限定，而页面链接是GET请求，也会触发失败（当前代码未限定方法，默认支持GET）。

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