IIS 10部署ASP.NET Core 3.1 Web API出现\\?\路径前缀报错如何解决

根因分析 #

• \\?\是Windows系统为支持超过260字符的长路径自动添加的前缀，本身不属于错误，不需要单独处理，你遇到的核心问题是物理路径识别失败，主要有以下几个可能的原因：

1. 未正确安装对应版本的ASP.NET Core 3.1 Hosting Bundle，仅安装了.NET Core Runtime，导致IIS的AspNetCoreModuleV2模块无法正常解析站点配置。
2. IIS应用程序池身份对站点根目录没有足够的访问权限，无法正确读取web.config和应用程序文件，导致相对路径解析异常。
3. web.config中使用的相对路径在InProcess托管模式下，和IIS工作进程的默认工作目录不匹配，引发路径拼接错误。
4. 应用程序池配置了错误的.NET CLR版本，ASP.NET Core应用不需要IIS托管CLR运行时，配置错误会导致配置解析失败。

补充说明：URL Rewrite组件完全支持IIS 10，且该问题和URL Rewrite无关，安装该组件无法解决当前问题。

解决方案 #

按以下顺序操作验证即可：

• 安装ASP.NET Core 3.1官方Hosting Bundle，注意版本必须和你开发用的ASP.NET Core 3.1版本完全匹配，安装完成后执行iisreset命令重启IIS，在IIS的「模块」功能中确认能找到AspNetCoreModuleV2。
• 配置站点根目录权限：右键站点根目录→属性→安全→编辑→添加，输入对象名称为IIS AppPool\你的应用程序池名称（替换成你站点绑定的应用程序池的实际名称），确认后给该身份授予「读取 & 执行」「列出文件夹内容」「读取」权限。如果开启了stdout日志，还需要手动在站点根目录创建logs文件夹，并给上述应用程序池身份授予该文件夹的「写入」权限。
• 修改web.config配置：将aspNetCore节点的processPath属性中的相对路径标识.\删除，修改后配置如下：

<aspNetCore processPath="ShopApp.Server.API.exe" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="InProcess" />

• 调整应用程序池配置：打开IIS应用程序池列表，找到站点绑定的应用程序池→基本设置，将「.NET CLR版本」选项修改为「无托管代码」。
• 兼容测试：如果以上操作完成后问题仍存在，可以将hostingModel属性值修改为OutOfProcess，排除InProcess模式的兼容问题。

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