如何通过IIS预览ASP.NET Core网站的开发变更？

一、安装必备组件 #

• 安装ASP.NET Core托管捆绑包：版本需与你的项目.NET Core版本匹配，这是IIS处理ASP.NET Core请求的核心依赖。
• 检查项目文件（.csproj）：确保包含以下配置，启用Razor视图实时编译（开发环境默认启用，但手动确认更稳妥）：

  <PropertyGroup>
    <RazorCompileOnBuild>false</RazorCompileOnBuild>
    <RazorCompileOnPublish>true</RazorCompileOnPublish>
  </PropertyGroup>
  

二、正确配置IIS站点与应用程序池 #

1. 配置应用程序池
   • 新建应用程序池，设置：
     • .NET CLR版本：无托管代码
     • 托管管道模式：集成
2. 设置站点物理路径
   • 物理路径必须指向你的ASP.NET Core项目根目录（注意是单个项目的根目录，不是解决方案根目录，更不能是Views/Home这类子目录）。例如项目路径为C:\dev\MyPersonalWebApp，就填这个路径。
3. 验证处理程序映射
   • 进入站点的「处理程序映射」，确认存在AspNetCoreModuleV2的映射（路径规则为*，关联模块为AspNetCoreModuleV2）。如果缺失，以管理员身份打开命令提示符，执行：

     "%ProgramFiles%\IIS\Asp.Net Core Module\V2\aspnetcorev2.exe"
     

     重新注册ASP.NET Core模块。

三、启用开发环境实时刷新 #

1. 配置环境变量
   • 在站点的「配置编辑器」中，选择system.webServer/aspNetCore节点，设置environmentVariables里的ASPNETCORE_ENVIRONMENT为Development。
2. 验证路由与默认访问
   • ASP.NET Core的Razor视图不能直接通过浏览器访问，必须通过控制器路由触发。确保你的项目有默认路由配置（比如HomeController的Index动作），访问http://localhost或http://localhost/Home/Index即可加载Index.cshtml。
3. 实时刷新生效
   • 开发时修改cshtml文件后，直接刷新浏览器就能看到变更，无需重启IIS或重新发布。如果未生效，检查ASPNETCORE_ENVIRONMENT是否为Development，以及项目是否已重新生成（执行dotnet build或Visual Studio的「生成」按钮）。

四、解决HTTP 404.17错误 #

你遇到的错误是因为请求被静态文件处理程序接管，未传递给ASP.NET Core模块，按以下步骤修复：

• 确认应用程序池的.NET CLR版本为「无托管代码」，托管管道模式为集成。
• 确保站点物理路径是项目根目录，而非Views子目录（Views下的文件不能直接被静态文件处理程序解析）。
• 检查站点的「默认文档」，添加Index（ASP.NET Core路由会优先处理默认路径，但补充默认文档可避免不必要的404）。

开发流程提示 #

• 开发阶段无需配置发布设置，只需通过dotnet build或Visual Studio生成项目，确保bin\Debug\netX.X下的程序集为最新版本即可。
• 若使用Visual Studio，也可直接选择「IIS Express」调试，它会自动完成环境配置；如果坚持使用本地IIS，按上述步骤配置即可。

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