ASP.NET Core 8的HtmlRenderer是否线程安全？

核心结论 #

• HtmlRenderer本身是线程安全的，可放心将其包装类注册为单例（Singleton）。

说明 #

ASP.NET Core官方设计中，HtmlRenderer的核心渲染逻辑无状态，实例不会存储请求上下文或可变状态。多线程场景下（如控制器并发处理请求），多个线程可安全共享同一个HtmlRenderer实例执行渲染操作。

DI注册示例 #

若封装了邮件渲染服务，注册代码可参考：

builder.Services.AddSingleton<IMailHtmlRenderer, MailHtmlRenderer>();

// 包装类示例
public class MailHtmlRenderer : IMailHtmlRenderer
{
    private readonly HtmlRenderer _htmlRenderer;

    public MailHtmlRenderer(HtmlRenderer htmlRenderer)
    {
        _htmlRenderer = htmlRenderer;
    }

    public async Task<string> RenderMailTemplateAsync(string templatePath, object model)
    {
        return await _htmlRenderer.RenderComponentAsync<MailTemplateComponent>(parameters => 
            parameters.Add(p => p.Model, model));
    }
}

注意事项 #

• 传递给HtmlRenderer的模型数据需保证线程安全，或每个请求使用独立模型实例，避免多线程状态冲突。
• 若渲染过程依赖作用域服务（如数据库上下文），不要在单例包装类中直接注入，应通过IServiceScopeFactory创建临时作用域获取服务。

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