MAUI Blazor中Telerik Reporting缓存问题求助

问题背景 #

基于.NET7的Blazor MAUI Windows应用，使用Telerik Reporting实现报表功能，组件代码如下：

@if (SourceOptions != null)
{
    <ReportViewer ViewerId="ReportView"
              ServiceUrl="@ReportSetting.ReportRestServicePath"
              ReportSource="@SourceOptions"
              Parameters="@(new ParametersOptions { Editors = new EditorsOptions { MultiSelect = EditorType.ComboBox, SingleSelect = EditorType.ComboBox } })"
              ScaleMode="@(ScaleMode.Specific)"
              @ref="__refReportViewer"
              ParametersAreaVisible=false
              Scale="1.0" />
}
@code{
    [Parameter] public TerlrikReportOptions ReportSetting { get; set; }

    [Parameter] public EventCallback CloseReportDelegate { get; set; }

    private ReportSourceOptions SourceOptions;

    private ReportViewer __refReportViewer;

    public BLReportViewer()
    {
    }

    protected override Task OnParametersSetAsync()
    {
        SourceOptions = new ReportSourceOptions();
        SourceOptions.Report = ReportSetting.ReportName;
        SourceOptions.Parameters = ReportSetting.ReportParameters;
        return base.OnParametersSetAsync();
    }
}

运行时频繁出现以下异常：

• 报表无数据显示空白页
• 仅显示页眉页脚，内容缺失
• 报表本身无问题时弹出红色报表构建错误提示
  重启应用后恢复，且新版本首次安装时问题高发，怀疑为缓存导致。

解决方法 #

1. 加载新报表前强制清除Viewer缓存 #

利用ReportViewer实例的ClearCache()方法，在每次参数更新、加载新报表前清除本地缓存，避免复用旧数据：

修改OnParametersSetAsync方法：

protected override async Task OnParametersSetAsync()
{
    // 若Viewer已初始化，先清除缓存
    __refReportViewer?.ClearCache();

    SourceOptions = new ReportSourceOptions();
    SourceOptions.Report = ReportSetting.ReportName;
    SourceOptions.Parameters = ReportSetting.ReportParameters;

    await base.OnParametersSetAsync();
}

2. 添加缓存破击参数，避免服务端缓存命中 #

给报表参数添加一个唯一的缓存破击标识（如时间戳），让Telerik REST服务将每次请求视为新请求，绕过服务端缓存：

protected override async Task OnParametersSetAsync()
{
    __refReportViewer?.ClearCache();

    SourceOptions = new ReportSourceOptions();
    SourceOptions.Report = ReportSetting.ReportName;

    // 复制原有参数并添加缓存破击项
    var reportParams = ReportSetting.ReportParameters != null 
        ? new Dictionary<string, object>(ReportSetting.ReportParameters) 
        : new Dictionary<string, object>();
    // 唯一标识确保每次请求不同
    reportParams["_CacheBuster"] = DateTime.UtcNow.Ticks.ToString();
    SourceOptions.Parameters = reportParams;

    await base.OnParametersSetAsync();
}

3. 组件销毁时释放Viewer资源 #

实现IDisposable接口，在组件卸载时释放ReportViewer资源，避免残留缓存占用：

@implements IDisposable

// ... 原有组件代码 ...

public void Dispose()
{
    __refReportViewer?.Dispose();
}

4. 服务端禁用报表缓存 #

在Telerik Report REST服务的配置中，直接禁用缓存，从根源避免缓存问题：

在服务端的Program.cs/Startup.cs中修改配置：

services.AddReporting(config =>
{
    // 其他配置...
    config.UseNullCache(); // 禁用报表缓存
});

5. 新版本首次启动清理本地缓存目录 #

Blazor MAUI Windows应用的本地缓存位于Environment.SpecialFolder.LocalApplicationData下的应用专属目录，可在应用启动时检查版本变更，清理Telerik相关缓存文件：

// 在应用启动逻辑中添加
var currentVersion = Assembly.GetExecutingAssembly().GetName().Version.ToString();
var cacheDir = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "YourAppName", "TelerikReporting");
var lastVersion = Preferences.Get("LastAppVersion", string.Empty);

if (currentVersion != lastVersion && Directory.Exists(cacheDir))
{
    Directory.Delete(cacheDir, recursive: true);
    Preferences.Set("LastAppVersion", currentVersion);
}

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