ASP.NET Core MVC项目报错：无法覆盖<a>的href属性

这个报错的核心原因是a标签同时指定了原生href属性和ASP.NET Core Tag Helper的asp-action/asp-controller属性，框架无法同时处理这两种属性生成链接，所以抛出InvalidOperationException。即使你撤销了自己的代码修改，问题依然存在，大概率是全局配置、缓存或者布局页/视图导入的问题导致的，下面是具体解决步骤：

1. 检查全局Tag Helper配置 #

打开项目根目录下的_ViewImports.cshtml文件，查看@addTagHelper指令：

• 确保只有官方的Tag Helper引用：@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers，如果存在第三方库或自定义的Tag Helper引用，暂时注释掉，重新运行项目测试是否恢复正常。
• 如果你自己写了自定义Tag Helper，检查其逻辑是否会自动给所有a标签添加asp-action/asp-controller属性——这种错误配置会导致所有a标签被强制注入冲突属性。

2. 清理项目与浏览器缓存 #

• 删除项目的bin和obj文件夹，然后在VS Code的终端执行dotnet clean和dotnet build命令重新生成项目，清除编译缓存。
• 清空浏览器缓存（快捷键Ctrl+Shift+Del），或者使用无痕模式打开页面，避免浏览器加载旧的渲染结果。
• 重启VS Code和项目进程，排除IDE缓存的干扰。

3. 检查布局页与视图中的a标签 #

即使你撤销了自己的修改，布局页（_Layout.cshtml）或共享视图中的a标签可能本身就存在冲突配置：

• 查找所有<a>标签，确认是否同时存在href和asp-action/asp-controller属性，比如：

  <!-- 错误示例：同时存在href和asp属性 -->
  <a href="/Home/Index" asp-action="Index" asp-controller="Home">首页</a>
  

• 将冲突的标签修改为二选一：要么保留原生href，要么使用Tag Helper属性（移除href）：

  <!-- 正确示例1：使用原生href -->
  <a href="/Home/Index">首页</a>
  
  <!-- 正确示例2：使用ASP.NET Core Tag Helper -->
  <a asp-action="Index" asp-controller="Home">首页</a>
  

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