ASP.NET Web Application调试与部署页面路径不兼容问题求解

核心原因 #

调试时站点根路径为https://localhost:44322/，部署后站点根路径为http://ApplicationName/，硬编码的/ApplicationName前缀在调试环境下会被当成站点根下的子目录，导致找不到页面。

解决方案：使用ASP.NET根路径解析符~ #

ASP.NET提供~符号表示应用程序根目录，配合服务器端方法ResolveUrl或ResolveClientUrl，可自动根据当前环境生成正确的URL路径。

修改后的代码 #

将原来硬编码的URL替换为动态解析的路径：

<Head title="WhycantIdebugbutafterdeploythisworks" url="#">
<MenuItem title="Some Menu" url="<%= ResolveUrl("~/AFolder/First.aspx") %>" />
<MenuItem title="Another Menu" url="<%= ResolveUrl("~/AFolder/Second.aspx") %>" /></Head>

原理说明 #

• 调试环境下：~/AFolder/First.aspx会被解析为/AFolder/First.aspx，对应调试URLhttps://localhost:44322/AFolder/First.aspx
• 部署环境下：~/AFolder/First.aspx会被解析为/ApplicationName/AFolder/First.aspx，对应部署URLhttp://ApplicationName/AFolder/First.aspx

补充说明 #

如果你的MenuItem是ASP.NET自带的服务器控件，可直接设置NavigateUrl属性为~/AFolder/First.aspx，服务器控件会自动处理路径解析：

<asp:MenuItem Text="Some Menu" NavigateUrl="~/AFolder/First.aspx" />

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