如何排查IIS部署.NET 5.0应用时无法读取web.config且无报错的问题

API 探路者

2026-9-30

排查思路

先开启应用 stdout 日志排查具体错误：将web.config里的stdoutLogEnabled属性改为true，在站点根目录手动创建logs文件夹，重启站点后访问，查看logs目录下生成的日志文件，可定位到具体的启动失败原因，比如 DLL 路径错误、运行时依赖缺失、应用内部配置错误等。
验证 IIS 模块是否正常加载：打开 IIS 管理器，查看当前服务器/站点的「模块」列表，确认AspNetCoreModuleV2存在且已启用。如果找不到该模块，可尝试重装 .NET 5 托管捆绑包，安装完成后执行iisreset重启 IIS 再验证。
校验web.config的 XML 合法性：将配置内容复制到 Visual Studio 或系统记事本中，检查是否存在不可见的特殊字符、编码是否为 UTF-8 无 BOM 格式，特殊隐藏字符会导致 XML 解析失败但表面看不到内容错误。
切换托管模式测试：将web.config里的hostingModel属性从inprocess改为outofprocess，重启站点后测试是否能正常访问，排除进程内托管模式的兼容性问题。
直接本地启动应用排查：在服务器命令行中进入站点根目录，执行dotnet .\TestApp.Web.dll，如果命令行启动失败，说明问题出在应用本身（比如appsettings.json配置错误、依赖文件缺失等），和 IIS 配置无关；如果命令行可以正常启动，说明问题锁定在 IIS 托管链路的配置上。
检查 IIS 功能完整性：确认服务器的服务器角色中已安装「Web 服务器（IIS）」下的 ASP.NET 相关功能组件，必要时可安装对应版本的 .NET 5 SDK 再测试，部分场景下仅安装托管运行时会存在依赖缺失问题。
清理临时缓存测试：清空 IIS 临时配置缓存和 ASP.NET 临时文件目录，执行iisreset彻底重启 IIS 后再尝试访问站点。