IIS 网站“未能映射路径‘/’”错误的解决方案

在使用 IIS（Internet Information Services） 部署 .NET 网站时，可能会遇到 “未能映射路径‘/’” 的错误。这通常是由于 .NET 版本不匹配、IIS 配置错误 或 站点目录权限不足 造成的。本文将深入分析问题原因并提供详细的解决方案，帮助你快速恢复网站访问。

一、问题描述

1. 错误信息

在 IIS 托管 .NET 网站时，可能会出现以下错误：

“/”应用程序中的服务器错误。
未能映射路径“/”。

或者在 Event Viewer（事件查看器） 记录的日志中看到：

System.InvalidOperationException: 未能映射路径“/”。

二、错误原因分析

1. .NET 版本问题

✅ IIS 应用程序池使用的是 .NET 4.5，但网站代码可能需要更高版本（如 .NET 4.7 或 .NET 4.8）。

2. IIS 配置错误

✅ IIS 站点可能没有正确指定 .NET 版本，导致网站无法解析路径。

3. .NET Framework 未正确安装

✅ .NET 4.5 安装后未重启服务器，导致 IIS 解析路径时出错。

4. 网站目录权限不足

✅ IIS 运行账户没有访问网站根目录的权限，导致路径映射失败。

三、解决方案

方法 1：重启服务器

如果你最近安装或升级了 .NET Framework，但没有重启服务器，那么大概率是IIS 没有正确加载 .NET 运行环境，可以尝试重启服务器：

shutdown -r -t 0

✅ 重启后，再次访问网站，查看是否恢复正常。

方法 2：升级 .NET Framework

如果你的 .NET 版本是 4.5，建议升级到更高版本（如 .NET 4.7 或 4.8）。

1. 检查当前 .NET 版本

在 windows 命令行（CMD） 输入：

reg query "HKEY_LOCAL_macHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" /v Version

如果返回的是 4.5，建议升级到 4.7 或 4.8。

2. 下载并安装 .NET 4.8

官方下载地址： 🔗 .NET 4.8 运行时

✅ 安装完成后，重启服务器，并重新测试网站访问。

方法 3：检查 IIS 应用程序池的 .NET 版本

如果 .NET 版本无误，但网站仍然报错，可能是 IIS 应用程序池设置错误，可以手动调整。

1. 进入 IIS 管理器

1. Win + R，输入 inetmgr，打开 IIS 管理器。
2. 在左侧选择网站，然后在右侧点击“高级设置”。

2. 修改应用程序池的 .NET 版本

1. 点击 应用程序池（application Pools）。
2. 找到你的网站对应的应用程序池。
3. 右键 “高级设置”，找到 “.NET CLR 版本”，确保选择的是 .NET CLR v4.0 或 更高版本。

✅ 重启 IIS 并测试网站是否恢复正常：

iisreset

方法 4：检查网站目录权限

如果 .NET 版本和 IIS 配置都正确，但仍然报错，可能是IIS 没有权限访问网站根目录。

1. 赋予 IIS 访问权限

1. 右键网站目录 → 选择 属性 → 安全 选项卡。
2. 点击“编辑” → “添加”。
3. 输入：
   IIS_IUSRS
   

4. 赋予 读取 & 执行 权限，点击 确定。

✅ 重启 IIS 站点，再次尝试访问网站。

方法 5：手动注册 .NET 到 IIS

如果升级 .NET Framework 后仍然无法解决问题，可以尝试手动注册 .NET 到 IIS：

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i

✅ 重新启动 IIS：

iisreset

四、总结