.NET Core Web API用Razor CSHTML模板渲染HTML时静态资源加载失败

你在手动调用IViewEngine渲染Razor模板为字符串时，没有给构造的DefaultHttpContext补全请求相关的基础配置，Razor内置的标签辅助器无法解析~（应用根路径占位符）对应的实际路径，会直接过滤掉无法正确解析的资源引用标签，所以你写的本地CSS引用的link标签渲染后直接消失。
另外你配置的UseStaticFiles是用来处理HTTP请求返回静态资源的，和Razor模板渲染字符串的逻辑完全无关，不需要调整这部分配置。

方案1：直接禁用标签辅助器，写死资源路径（最简单） #

如果你的报表HTML会部署到对应服务的目录下访问，只需要在CSHTML的资源标签前加!禁用标签辅助器的自动解析，同时把~替换为实际的相对路径即可：

<!link rel="stylesheet" href="./StaticFiles/bootstrap.min.css"/>
<!img src="./XXXXlogo.png" alt="ANY IMAGE" />

方案2：补全HttpContext配置，让标签辅助器正常工作 #

在构造DefaultHttpContext时补上服务的域名、协议等信息，Razor就能正确解析~占位符：

var httpContex = new DefaultHttpContext
{
    RequestServices = _serviceProvider,
    Request = 
    {
        Scheme = "https", // 按需换成http
        Host = new HostString("你的服务实际域名或IP:端口"),
        PathBase = "" // 如果服务有二级路径就填这里
    }
};

方案3：静态资源内联（更适合报表场景） #

报表通常需要单独分发，建议直接把静态资源内容内联到HTML中，不需要依赖外部资源，单个文件即可正常打开：

CSS内联 #

<head>
    <style>
        @await File.ReadAllTextAsync(Path.Combine(AppContext.BaseDirectory, "StaticFiles/bootstrap.min.css"))
    </style>
</head>

图片内联 #

把图片转成base64后写入src属性即可，示例：

<img src="@("data:image/png;base64," + Convert.ToBase64String(await File.ReadAllBytesAsync(Path.Combine(AppContext.BaseDirectory, "XXXXlogo.png"))))" alt="ANY IMAGE" />

如果你的项目主要场景是用Razor模板生成HTML，不需要处理MVC的页面请求，可以改用轻量的Razor模板库比如RazorLight，不需要手动构造ActionContext、ViewContext等复杂上下文，配置更简单，更适配Web API项目的场景。

内容的提问来源于stack exchange，提问作者Harimanda Jerrys Randriamire