使用asp-page TagHelper时部分链接未渲染且手动访问报404错误

听起来你遇到了个挺闹心的问题——同样是Admin菜单里的链接，Users能正常生成完整路由，Roles却只渲染到根路径，手动访问还404。结合你描述的情况，我给你梳理几个排查方向：

1. 先核对页面文件的位置与命名 #

• 确认Roles.cshtml是否确实放在了/Pages/Admin/目录下？毕竟Users能正常渲染，说明Admin这个目录的路由映射是没问题的，很可能是Roles页面的位置不对（比如误放到了根目录/Pages/下），或者文件名拼写/大小写有误（比如写成了Role.cshtml少了个s，或者roles.cshtml全小写——虽然Windows文件系统不区分大小写，但TagHelper的路由匹配可能会严格校验）。
• 另外也检查下有没有对应的Roles.cshtml.cs后台代码文件？虽然空页面也能渲染，但如果这个页面加了自定义路由属性（比如[Route]），也可能干扰TagHelper的路由生成。

2. 检查asp-page属性的写法 #

把两个链接的TagHelper代码对比一下，比如Users的应该是类似这样：

<a asp-page="/Admin/Users">Users</a>

那Roles的链接是不是写成了：

<a asp-page="/Admin/Roles">Roles</a>

有没有可能不小心写成了asp-page="/Roles"（漏掉了Admin前缀）？或者拼写错误（比如/Admin/Role）？这种小失误很容易导致路由只生成到根路径。

3. 验证路由配置是否正常 #

• 检查你的Program.cs（或者旧版本的Startup.cs）里，是否正确启用了Razor Pages路由：

  var builder = WebApplication.CreateBuilder(args);
  builder.Services.AddRazorPages(); // 确保添加了Razor Pages服务
  var app = builder.Build();
  // ... 其他中间件配置
  app.MapRazorPages(); // 确保映射了Razor Pages路由
  app.Run();
  

• 有没有给Admin页面添加过自定义路由约束？比如在Roles.cshtml.cs里加了[Route("SomeOtherPath")]，这会覆盖默认的页面路由，导致TagHelper生成的路径不对。

4. 清理项目缓存再试 #

有时候Visual Studio的缓存会搞出这种奇怪的不一致问题，试试：

• 点击菜单栏的Build -> Clean Solution
• 然后Build -> Rebuild Solution
• 重启调试服务器，再看链接渲染是否正常

如果以上步骤都排查过，还是有问题，可以把你_Layout里两个链接的具体代码贴出来，这样能更精准定位问题~

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