Handlebars注册Partial实现多租户模板渲染失效问题咨询

你当前方案失效的核心原因是踩了Handlebars（从代码看你用的是C#版Handlebars.Net）的全局Partial注册机制的特性：

• Handlebars.RegisterTemplate 是全局静态操作，后注册的同名Partial会直接覆盖之前注册的内容
• 编译后的模板不会在编译阶段把Partial内容固化进去，渲染时会实时从全局注册表查找对应Partial，所以哪怕你把两个租户的模板分别编译缓存，只要注册的Partial同名，最后所有模板渲染时都会使用最后一次注册的Partial内容，甚至多线程场景下会出现内容串租户的严重问题。
• 另外你重复编译完全相同的default.hbs主模板属于多余操作，没有任何实际收益，还会浪费内存和启动耗时。

你的整体思路（保留通用主模板、动态替换租户差异化区块）是完全可行的，只需要避开全局同名覆盖的坑即可，下面是两种可落地的实现方案：

方案1：修正Partial实现（适合租户差异化区块逻辑复杂、需要独立子模板的场景） #

不要给所有租户的差异化区块用同一个Partial名，给每个租户的Partial分配唯一标识，同时主模板改用动态Partial写法，主模板仅需编译一次。

1. 修改default.hbs主模板，把固定Partial引用改成动态绑定：

<html>
  <head>
    <title>{{Title}}</title>
  </head>
<body>
  <div>{{SomeStuff}}</div>
  <br>
  <div>
    {{> (TenantPartialKey) }}
  </div>
</body>
</html>

2. 应用启动阶段一次性完成主模板编译和所有租户Partial注册，不要在请求链路中重复操作：

// 主模板仅编译一次，全局缓存
string defaultTemplate = _templates.GetTemplate("Default");
var compiledMainTemplate = Handlebars.Compile(defaultTemplate);
_templateCache.Add("SharedDefault", compiledMainTemplate);

// 注册所有租户的差异化Partial，Key唯一不重复
Handlebars.RegisterTemplate("tenantDiv_Company1", @"<strong>Company ABC</strong>");
Handlebars.RegisterTemplate("tenantDiv_Company2", @"<strong>Company ZXY</strong>");

3. 渲染PDF时，根据当前租户传入对应的Partial Key即可：

// 识别到当前租户为Company1
var renderData = new {
    Title = "你的文档标题",
    SomeStuff = "通用区块内容",
    TenantPartialKey = "tenantDiv_Company1" // 对应租户的Partial唯一Key
};
string renderedHtml = _templateCache.Get("SharedDefault").Invoke(renderData);
// 用renderedHtml生成PDF即可

方案2：直接传参注入差异化内容（更简单，适合大多数场景） #

如果租户差异化区块没有复杂的渲染逻辑，完全不需要用Partial机制，直接把差异化内容作为模板变量传入即可，连Partial注册步骤都可以省略。

1. 修改default.hbs主模板，差异化区块直接用变量占位，注意用三个大括号避免HTML内容被转义：

<html>
  <head>
    <title>{{Title}}</title>
  </head>
<body>
  <div>{{SomeStuff}}</div>
  <br>
  <div>
    {{{TenantDivContent}}}
  </div>
</body>
</html>

2. 主模板同样只需要编译一次缓存，提前维护好租户ID和对应差异化HTML的映射关系：

// 提前维护租户差异化内容映射，也可以存在配置文件、数据库中
var tenantContentMap = new Dictionary<string, string>
{
    ["Company1"] = "<strong>Company ABC</strong>",
    ["Company2"] = "<strong>Company ZXY</strong>"
};

// 主模板编译一次全局缓存
string defaultTemplate = _templates.GetTemplate("Default");
var compiledMainTemplate = Handlebars.Compile(defaultTemplate);
_templateCache.Add("SharedDefault", compiledMainTemplate);

3. 渲染时根据租户直接传入对应内容即可：

var renderData = new {
    Title = "你的文档标题",
    SomeStuff = "通用区块内容",
    TenantDivContent = tenantContentMap["Company1"]
};
string renderedHtml = _templateCache.Get("SharedDefault").Invoke(renderData);

• 渲染HTML内容的变量一定要用三个大括号{{{ }}}包裹，两个大括号会把HTML标签转义为字符实体，最终页面会显示HTML源码而不是渲染后的内容
• 尽量在应用启动阶段完成所有模板编译、Partial注册操作，不要在每次请求时动态注册/编译，避免并发场景下的注册冲突、性能损耗问题
• 如果租户数量很大，不想启动时全量注册所有Partial，可以自定义Handlebars的Partial解析器，渲染时按需加载对应租户的模板内容，无需提前全局注册

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