ASP.NET MVC锚点标签助手将id拼接为查询串而非路由数据的解决方法

你遇到的链接生成格式不符合预期，核心原因来自无参Details()动作上额外添加的路由特性：

• 这个动作上的[Route("[controller]/[action]")]特性会生成一个全静态的路由模板Customer/Details，没有预留任何动态参数段。
• ASP.NET Core的路由匹配优先级规则中，全静态路由模板的优先级是最高的，比全局默认约定路由{controller=Home}/{action=Index}/{id?}的优先级高。
• 当锚点标签助手生成指向Customer/Details的链接时，会优先匹配这个高优先级的全静态路由端点。因为这个端点的模板里没有定义id参数的位置，框架会把传入的asp-route-id值当成多余参数，拼接成查询字符串，最终生成/Customer/Details?id=1的格式。

方案1：移除冗余的特性路由（推荐改动最小） #

你的全局默认约定路由本身就已经可以覆盖两个重载Details方法的访问需求：

• 当路径中没有id段时（如/Customer/Details），框架会自动匹配无参的Details()方法；
• 当路径中带有id段时（如/Customer/Details/1），框架会自动匹配带int id参数的Details(int id)方法。

直接删掉无参Details()方法上的[Route("[controller]/[action]")]特性即可，改动后的代码如下：

[Authorize(Roles = "Admin")]
public async Task<IActionResult> Details() {
    int userId = Convert.ToInt32(HttpContext.User.Identity.Name);
    return await Details(userId);
}

无需担心两个重载方法的路由匹配冲突，框架会根据路由段中是否存在可转换为int类型的id值，自动路由到参数匹配的动作方法，不存在歧义。调整后两个动作全部走全局约定路由，标签助手生成链接时会按照约定路由的{id?}段规则，自动把id值拼到路径位置，生成/Customer/Details/1的预期格式。

方案2：保留特性路由模式，明确路由模板参数 #

如果你后续需要在控制器上使用自定义路由规则，不想完全依赖全局约定路由，可以把分散在单个动作上的路由特性调整为控制器级别的统一配置，同时给带参的Details方法明确加上id的路由段定义：

// 控制器级统一路由前缀
[Route("[controller]/[action]")]
public class CustomerController : Controller {
    // 无参Details：匹配 /Customer/Details
    [HttpGet]
    [Authorize(Roles = "Admin")]
    public async Task<IActionResult> Details() {
        int userId = Convert.ToInt32(HttpContext.User.Identity.Name);
        return await Details(userId);
    }

    // 带参Details：明确定义可选id段，匹配 /Customer/Details/1
    [HttpGet("{id:int?}")]
    [Authorize(Roles = "Admin")]
    public async Task<IActionResult> Details(int id) {
        var model = GetUser();
        return View(model);
    }
}

这种配置下两个Details动作的路由模板都在特性路由体系内，id段被明确定义在路由模板中，标签助手生成链接时自然会把id值拼到路径位置，不会再转成查询字符串。

方案3：强制指定标签助手使用约定路由生成链接 #

如果不想改动任何控制器代码，也可以在锚点标签上添加asp-route="default"属性，强制标签助手匹配名字为default的全局约定路由模板生成链接，跳过优先级更高的静态特性路由端点。
不过这种方法属于绕开路由冲突的权宜之计，其他位置的标签助手如果没加这个属性，还是会遇到同样的生成格式问题，不推荐长期使用。

补充说明：你当前Startup.cs里的中间件顺序、Cookie策略配置都和这个路由生成问题无关，不需要改动。

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