Blazor WASM部署到IIS报Object reference not set空引用错误求助

定位步骤 #

• 开启详细运行日志：
  1. 若为ASP.NET Core托管模式的WASM项目，修改发布包根目录的web.config，在aspNetCore节点新增属性：stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout"，手动创建logs文件夹并给IIS应用池运行身份授予该文件夹的读写权限
  2. 修改wwwroot/appsettings.json配置，将Logging节点下的LogLevel默认等级调整为Debug，方便捕获更细粒度的报错信息
• 检查部署路径匹配：
  本地运行默认是根路径，若部署到IIS子应用下，必须修改wwwroot/index.html中的base标签为<base href="/你的子应用别名/" />，同时检查代码中所有硬编码的资源、API路径是否适配部署路径，可通过浏览器F12网络面板排查是否存在404请求，大部分空引用都来自请求失败后未判空直接使用返回值
• 验证部署文件完整性：
  对比本地运行的bin目录和发布包文件，检查是否遗漏了环境配置文件（如appsettings.Production.json）、第三方静态资源等未设置复制到发布目录的文件
• 检查IIS运行环境：
  确认服务器已安装与项目.NET版本匹配的ASP.NET Core 托管捆绑包，安装完成后必须重启IIS生效，缺失该模块会导致托管端运行异常抛出空引用

常见解决方案 #

• 服务注册缺失：检查Program.cs中的服务注册逻辑，是否存在仅在DEBUG环境下注册服务的条件判断，导致Release版本运行时服务未注入，调用时报空引用
• 空值处理缺失：给所有远程请求、配置读取的逻辑增加空值判断和异常捕获，避免上游返回空时直接调用属性/方法报错
• 路径适配错误：所有内部跳转、API请求不要硬编码根路径，使用NavigationManager提供的方法拼接路径，适配不同部署场景
• 环境依赖缺失：重新安装对应版本的ASP.NET Core托管捆绑包，重启IIS后重新部署项目

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