.NET 5 Razor Page 页面加载时OnGet方法未触发问题排查

你遇到的OnGet()方法始终不触发的问题，本质是Razor Tag Helper的适用边界和HTML原生元素的语义不匹配导致的跳转失效。

核心认知误区：asp-page不是可以给所有元素自动绑定跳转逻辑的通用属性，它是专为AnchorTagHelper设计的路由参数，只有绑定到带导航语义的<a>标签上时才会真正生效。

很多新手对Razor Tag Helper的认知存在偏差，觉得只要写了带asp-前缀的属性就会自动触发对应逻辑，实际上每个Tag Helper都有固定的识别元素范围，超出范围写的属性只会被当成无意义的自定义属性原样渲染，不会触发任何路由解析。
具体拆解两种写法的执行差异：

1. 原按钮写法为什么无法触发OnGet
   你最初使用的跳转代码：

   <button asp-page="AdminAddEmployee" class="btn btn-primary">Add Employee</button>
   

   原生<button>标签的设计定位是表单提交触发器，本身不具备页面导航的语义。Razor的路由Tag Helper根本不会识别这个按钮上的asp-page属性做路由解析，最终渲染到浏览器的DOM上，这就是一个没有任何跳转逻辑的普通按钮——点击时只会触发所在表单的默认提交行为（如果当前页面有包裹form标签的话），最多刷新当前页面，根本不会向AdminAddEmployee页面发起GET请求，自然目标页的OnGet()方法永远不会被命中。
   调试的时候可以打开浏览器F12开发者工具看最终渲染的DOM，就能看到asp-page只是被原样输出成自定义属性，完全没有生成跳转需要的路由地址。
2. 换成a标签后OnGet为什么可以正常执行
   调整后的跳转代码：

   <a asp-page="AdminAddEmployee" class="btn btn-primary">Add Employee</a>
   

   <a>是天生带导航语义的HTML元素，会被AnchorTagHelper正常识别处理：Tag Helper会自动解析asp-page指向的页面路由，给a标签的href属性生成正确的访问地址，用户点击时浏览器就会向目标页面发起标准GET请求，自然能正常触发目标页的OnGet()方法。哪怕给a标签加了按钮的CSS类，只要标签本身的导航语义不变，跳转逻辑就不会失效。

• 页面跳转类的交互入口，优先用带asp-page的<a>标签实现：需要按钮视觉效果时直接给a标签加Bootstrap的btn、btn-primary等类即可，样式和原生button完全一致，但能保证路由解析正确、跳转逻辑稳定。
• 不要给非导航语义的元素随意加asp-page属性：asp-page本质是路由生成参数，单独加在button、span、div等元素上时不会触发任何Tag Helper逻辑，也不会绑定跳转行为，属于完全无效的写法。
• 如果确实需要用button实现跳转，不能依赖asp-page属性：需要给按钮配置formaction属性指向目标页面路由，配合所在表单的method="get"设置触发导航，或者手写JS点击事件绑定跳转地址，否则点击行为只会触发表单提交，和目标页面的导航逻辑没有关系。
• 调试跳转类问题优先检查最终DOM渲染结果：不要只看Razor页面的源代码，要在浏览器开发者工具的元素面板里确认可点击元素是否正确生成了href、formaction这类导航属性——如果只看到裸露的asp-page自定义属性，就说明Tag Helper没有生效，自然无法触发目标页面的OnGet逻辑。

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