Blazor项目VS在Win10/Win11生成web.config的dotnet.exe路径差异问题

路径差异的原因 #

1. IIS站点物理路径不匹配：Win11上IIS中对应项目的站点物理路径与Win10不一致，导致Visual Studio生成相对路径时的基准目录偏差，出现多层../的路径结构。
2. .NET托管捆绑包注册异常：Win11上的.NET托管捆绑包未正确向IIS完成注册，VS无法通过注册表获取dotnet.exe的绝对路径，只能 fallback 生成相对路径。
3. VS调试逻辑细节差异：尽管都是最新版VS2022，但Win11环境下的VS可能采用了不同的IIS调试路径生成策略，导致相对路径生成逻辑出现异常。

修复方法 #

1. 强制指定绝对路径（最直接有效） #

修改项目的.csproj文件，添加固定的dotnet.exe绝对路径配置，让VS生成web.config时自动使用该路径：

<PropertyGroup>
  <AspNetCoreProcessPath>C:\Program Files\dotnet\dotnet.exe</AspNetCoreProcessPath>
</PropertyGroup>

保存后重新生成项目，web.config中的processPath会自动变为绝对路径，无需手动修改。

2. 修复.NET托管捆绑包注册 #

下载你使用的.NET版本对应的托管捆绑包安装程序，运行时选择修复选项，确保IIS的ASP.NET Core模块正确注册，让VS能自动识别dotnet.exe的绝对路径。

3. 调整IIS站点物理路径 #

打开Win11的IIS管理器，找到项目对应的站点，检查物理路径是否与Win10一致（通常应为项目根目录）。如果物理路径指向项目子目录，会导致相对路径解析错误，调整后重新生成项目即可。

4. 修正VS调试配置 #

右键项目→属性→调试，检查IIS配置中的物理路径是否正确指向项目根目录，同时确认“应用URL”配置无异常，保存配置后重新生成项目。

补充说明 #

为什么理论正确的相对路径会失效？因为IIS应用池的工作目录并非VS生成相对路径时的基准目录——VS以项目目录为基准，但IIS可能以C:\inetpub\wwwroot或系统目录为工作目录，导致相对路径无法正确定位到dotnet.exe，改用绝对路径可彻底规避该问题。

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