Visual Studio 2022中ASP.NET WebForms项目localhost拒绝连接问题

问题描述 #

运行Visual Studio 2022中的ASP.NET WebForms项目时，浏览器无法加载默认页面，调试输出显示程序[14356] iisexpress.exe已退出，代码为0(0x0)；清理解决方案后再次运行，浏览器提示“无法访问此网站”，localhost拒绝连接，错误码为ERR_CONNECTION_REFUSED。

关联的Default.aspx代码（已翻译为中文）：

<%@ Page Title="主页" Language="C#" MasterPageFile="~/Site.Master" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="WebApplication4._Default" %>

<asp:Content ID="BodyContent" ContentPlaceHolderID="MainContent" runat="server">

    <main>
        <section class="row" aria-labelledby="aspnetTitle">
            <h1 id="aspnetTitle">ASP.NET</h1>
            <p class="lead">ASP.NET是免费的Web框架，可通过HTML、CSS和JavaScript构建优质网站与Web应用。</p>
            <p><a href="http://www.asp.net" class="btn btn-primary btn-md">了解更多 »</a></p>
        </section>

        <div class="row">
            <section class="col-md-4" aria-labelledby="gettingStartedTitle">
                <h2 id="gettingStartedTitle">快速入门</h2>
                <p>
                    ASP.NET Web Forms支持通过熟悉的拖放、事件驱动模型构建动态网站。
                    借助设计界面和数百个控件组件，可快速搭建复杂、功能强大的UI驱动型数据访问站点。
                </p>
                <p>
                    <a class="btn btn-default" href="https://go.microsoft.com/fwlink/?LinkId=301948">了解更多 »</a>
                </p>
            </section>
            <section class="col-md-4" aria-labelledby="librariesTitle">
                <h2 id="librariesTitle">获取更多库</h2>
                <p>
                    NuGet是免费的Visual Studio扩展，可便捷地在项目中添加、移除和更新各类库与工具。
                </p>
                <p>
                    <a class="btn btn-default" href="https://go.microsoft.com/fwlink/?LinkId=301949">了解更多 »</a>
                </p>
            </section>
            <section class="col-md-4" aria-labelledby="hostingTitle">
                <h2 id="hostingTitle">Web托管</h2>
                <p>
                    您可以轻松找到能为应用提供合适功能与价格组合的Web托管服务商。
                </p>
                <p>
                    <a class="btn btn-default" href="https://go.microsoft.com/fwlink/?LinkId=301950">了解更多 »</a>
                </p>
            </section>
        </div>
    </main>

</asp:Content>

解决步骤 #

1. 清理IIS Express缓存配置 #

• 关闭Visual Studio，删除项目根目录下的.vs隐藏文件夹（需开启系统显示隐藏项），重新打开项目并运行。
• 右键项目 → 属性 → 调试，确认启动浏览器选项指向正确的默认页面（如Default.aspx），同时检查App URL的端口是否被占用，可尝试修改端口号后重新运行。

2. 重置IIS Express #

• 打开命令提示符，执行命令：iisexpress /reset，重置IIS Express的配置，之后重启Visual Studio运行项目。

3. 验证项目文件完整性 #

• 确认Default.aspx.cs文件存在且与页面的CodeBehind、Inherits属性完全匹配，检查Site.Master文件是否存在且无语法错误。
• 清理解决方案后，右键项目 → 重新生成，确保编译过程无报错。

4. 检查Visual Studio组件安装 #

• 打开Visual Studio安装程序，确认已安装项目目标框架对应的.NET Framework开发组件，以及ASP.NET和Web开发工作负载。

5. 排查端口占用情况 #

• 使用命令netstat -ano | findstr :[项目端口号]（替换为实际使用的端口），查看是否有其他进程占用该端口，若有则结束对应进程后重新运行项目。

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