.NET中IHtmlContent WriteTo在父组件Dispose后调用的问题排查

我正在开发一款Bootstrap流畅框架，示例用法如下：

@using (Html.Bootstrap().Form().Begin())
{
    @Html.Bootstrap().Input()
}

容器Form的Dispose方法先于Input的WriteTo方法被调用。Input继承自.NET Core内置IHtmlContent接口，Begin方法手动写入HtmlHelper ViewContext，Dispose时结束标签，页面HTML输出正常，但组件栈操作出现问题：父组件释放后清空栈，子组件操作时栈为空。

调用顺序输出：

BootstrapContent.Begin for Form invoked.
ComponentBuilder.Dispose for Form invoked.
BootstrapContent.WriteTo for Input invoked.

环境：应用层使用.NET 6，类库用.NET Standard 2.1，升级到.NET 7后问题依旧，已创建issue/dispose分支供查看。

原因分析 #

这是Razor视图的执行机制导致的：@using块的Dispose逻辑会在块内代码解析完成后立即触发，而IHtmlContent的WriteTo是延迟执行的——只有当视图渲染到该组件位置时，才会调用其WriteTo方法。这种执行顺序差异，导致父组件已经释放并清空组件栈，子组件才开始尝试操作栈。

解决方案 #

方案1：将子组件栈关联逻辑提前到组件创建阶段 #

不在WriteTo阶段获取父组件，而是在创建子组件时立即从组件栈中关联父节点，确保父组件释放前完成栈操作：

// 修改Input组件的创建逻辑
public Input CreateInput()
{
    var input = new Input();
    // 创建时直接关联当前父组件，而非等到WriteTo
    if (_componentStack.Any())
    {
        var parent = _componentStack.Peek();
        parent.AddChildComponent(input);
    }
    return input;
}

方案2：延迟父组件的Dispose清理逻辑 #

不依赖using块的Dispose来写入结束标签和清空栈，而是将这些操作注册到ViewContext的OnCompleted回调中，确保在整个视图渲染完成后再执行父组件清理：

public IDisposable Begin()
{
    // 写入组件开始标签
    _viewContext.Writer.Write($"<{ComponentTagName}>");
    // 将结束标签写入和栈清理注册到视图完成回调
    _viewContext.OnCompleted(() =>
    {
        _viewContext.Writer.Write($"</{ComponentTagName}>");
        _componentStack.Pop();
    });
    return new ComponentBuilder(this);
}

方案3：显式控制组件生命周期 #

放弃using语法糖，改为显式调用开始和结束方法，严格控制执行顺序：

var form = Html.Bootstrap().Form().Begin();
@Html.Bootstrap().Input()
form.End(); // 显式结束父组件，确保子组件渲染完成后再清理栈

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