ASP.NET Core 6.0点击锚链接时Razor页面OnGet处理程序未调用

数据老陈

2026-8-27

问题原因

问题核心是点击锚点跳转时没有触发完整的服务端页面请求：直接输入地址/手动刷新属于硬导航，会卸载当前页面发起全新的服务端请求，因此能正常触发OnGet；点击链接时属于软导航，被客户端逻辑拦截，没有走到Razor Pages的请求管线，常见诱因有3类：

.NET 8及以上版本的Razor Pages/Blazor Web App默认开启增强导航（Enhanced Navigation）功能，会自动拦截站内<a>标签点击，用fetch发起局部内容更新请求，配置不当时不会触发完整的PageModel生命周期
页面引入了第三方无刷新导航库（Turbo、PJAX、全局配置的jQuery Unobtrusive Ajax等），拦截了a标签默认跳转行为，用AJAX拉取页面时没有正确路由到对应PageModel
硬编码href路径存在匹配问题、缓存规则配置错误，导致点击时直接读取本地缓存、或被重定向到其他静态资源，没有命中About页面的OnGet处理程序

修复方案

按优先级依次排查修复：

替换硬编码链接为标签助手生成的路径
不要直接写死href属性，用Razor内置的asp-page标签助手自动生成正确路由，避免虚拟目录部署、路由规则调整导致的路径不匹配问题，替换footer代码如下：

<div class="footer-left">
    <ul>
        <li><a asp-page="/About">About</a></li>
        <li><a asp-page="/Privacy">Privacy Policy</a></li>
        <li><a asp-page="/CookieList">Cookies List</a></li>
        <li><a asp-page="/Terms">Terms of use</a></li>
    </ul>
</div>

如果需要临时绕过所有客户端拦截，也可以给对应a标签加data-enhance="false"属性，强制浏览器走原生全页面跳转：

<a asp-page="/About" data-enhance="false">About</a>

处理.NET 8+默认增强导航的影响
如果项目是.NET 8及以上版本，可根据需求二选一处理：

适配增强导航：确保布局页中@RenderBody()的父容器没有被移除，动态内容区域正确配置data-enhance标记，无需修改PageModel代码即可正常触发OnGet
全局关闭增强导航：如果不需要无刷新跳转功能，直接在Program.cs的路由配置中关闭该特性，修改代码如下：

// 原配置代码：app.MapRazorPages();
app.MapRazorPages().DisableEnhancedNavigation();

排查前端脚本拦截
检查布局页引用的JS脚本，确认是否存在以下内容：

TurboLinks、PJAX等无刷新跳转库的引用
全局绑定a标签click事件、调用e.preventDefault()拦截默认跳转的自定义脚本
jQuery Unobtrusive Ajax的全局拦截配置
找到后要么调整拦截规则，排除页脚导航链接，要么暂时注释脚本引用验证问题。

排查缓存配置问题
打开浏览器开发者工具（F12）的网络面板，勾选「禁用缓存」后点击链接测试，如果此时OnGet能正常触发，说明是缓存导致：

检查Program.cs中的ResponseCache配置、静态文件缓存规则，不要对.cshtml动态页面配置长时强缓存，动态页面建议设置Cache-Control: no-cache
如果站点注册了Service Worker，调整缓存规则将动态页面路径排除在离线缓存外，更新Service Worker版本清除旧缓存

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