ASP.NET Core 3.1 Web API发布到IIS后WebRootPath为空的问题

先解决WebRootPath为空的问题 #

你遇到的WebRootPath为空，大概率是ASP.NET Core 3.1未正确启用静态文件中间件导致的：

• 检查Startup.cs的Configure方法，必须添加app.UseStaticFiles()——这是WebRootPath能被正确识别的前提，哪怕你不需要对外暴露静态文件，只要代码里要用到WebRootPath，就必须配置这一行。
• 若已配置仍为空，直接改用ContentRootPath构建路径是更稳妥的方案，因为它不受静态文件中间件的影响。

路径配置的具体方案 #

1. 报表路径（根目录下的Reports文件夹） #

报表不在wwwroot目录内，直接用ContentRootPath拼接最可靠，它始终指向应用发布后的根文件夹：

report.ReportPath = Path.Combine(_hostEnv.ContentRootPath, "Reports", "SalesSummary.rdlc");

用Path.Combine替代手动字符串拼接，能避免跨平台路径分隔符的问题，也不需要替换"wwwroot"这类字符串，减少出错概率。

2. 图片路径（wwwroot内的Storage/Invoice/InvLogo.png） #

图片在wwwroot里，有两种稳定的配置方式：

• 方式一：修复WebRootPath后拼接（需确保app.UseStaticFiles()已配置）：

  imagePath = Path.Combine(_hostEnv.WebRootPath, "Storage", "Invoice", "InvLogo.png");
  

• 方式二：直接用ContentRootPath拼接wwwroot子目录，无需依赖WebRootPath的状态：

  imagePath = Path.Combine(_hostEnv.ContentRootPath, "wwwroot", "Storage", "Invoice", "InvLogo.png");
  

针对你疑问的解答 #

wwwroot文件夹是否是必需的？ #

不是必需的。wwwroot是ASP.NET Core默认的静态文件根目录，仅当你需要对外提供静态资源（比如图片、前端静态文件），或代码依赖WebRootPath时才需要保留；如果你的应用没有这类需求，完全可以删除wwwroot。

能否改用ContentRootPath替代WebRootPath？ #

完全可以，甚至更推荐在处理非静态资源（比如你的报表文件）时使用。ContentRootPath指向应用根目录，不受静态文件中间件配置影响，在任何部署环境下都能稳定返回正确路径，不会出现空值问题。

补充建议：为确保Reports文件夹在发布时被正确复制到输出目录，可在项目文件（.csproj）中添加以下配置：

<ItemGroup>
  <Content Include="Reports\**">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

内容的提问来源于stack exchange，提问作者MSBI-Geek