如何为Crystal Report生成设置超时或终止任务？已尝试方案无效

问题背景 #

使用Crystal Reports时，报表生成启动后会阻塞其他任务，且无法在指定时长后自动停止。尝试过取消令牌（Cancellation Token）和设置ConnectionInfo的连接超时，但均无效，任务仍会无限运行。需要实现报表生成的超时终止功能，同时明确如何设置SQL查询执行超时。

已尝试的方案 #

取消令牌实现超时 #

Task loadTask = Task.Run(async () =>
{
    await GenerateReportAsync(Dispatch, reportGenerationTimeOut);
}, cancellationTokenSource.Token);

// 等待任务完成或超时
Task completedTask = Task.WhenAny(loadTask, Task.Delay(TimeSpan.FromSeconds(Convert.ToInt32(reportGenerationTimeOut)))).Result; // 30秒超时

if (completedTask == loadTask)
{
    // 报表在超时内成功生成
}
else
{
    // 触发超时，尝试取消任务
    cancellationTokenSource.Cancel();
    // 跳转到报表错误页面
}

设置ConnectionInfo连接超时 #

public ReportDocument SetReportCommandTimeout(ReportDocument reportDocument, string commandTimeout)
{
    foreach (Table table in reportDocument.Database.Tables)
    {
        TableLogOnInfo logOnInfo = table.LogOnInfo;
        ConnectionInfo connectionInfo = new ConnectionInfo
        {
            ServerName = logOnInfo.ConnectionInfo.ServerName,
            DatabaseName = logOnInfo.ConnectionInfo.DatabaseName,
            UserID = logOnInfo.ConnectionInfo.UserID,
            Password = "Password",
        };
        
        connectionInfo.LogonProperties.Add(new NameValuePair2("Connect Timeout", commandTimeout));
        connectionInfo.LogonProperties.Set("Connect Timeout", commandTimeout);

        table.LogOnInfo.ConnectionInfo = connectionInfo;
        table.ApplyLogOnInfo(table.LogOnInfo);
    }
    return reportDocument;
}

有效解决方案 #

1. 在报表生成异步方法内部检查取消令牌 #

取消令牌仅传递给Task.Run是不够的，必须在GenerateReportAsync方法内部主动检查令牌状态，确保Crystal Reports的操作能响应取消请求：

public async Task GenerateReportAsync(Dispatch dispatch, int timeoutSeconds, CancellationToken cancellationToken)
{
    ReportDocument report = new ReportDocument();
    try
    {
        // 报表初始化逻辑
        cancellationToken.ThrowIfCancellationRequested();
        
        // 加载报表数据前检查令牌
        report.Load("YourReportPath.rpt");
        cancellationToken.ThrowIfCancellationRequested();
        
        // 绑定数据源或执行查询时，定期检查令牌
        foreach (var table in report.Database.Tables)
        {
            cancellationToken.ThrowIfCancellationRequested();
            // 应用登录信息等操作
        }
        
        // 导出或渲染报表前检查
        cancellationToken.ThrowIfCancellationRequested();
        // 执行报表生成逻辑
    }
    catch (OperationCanceledException)
    {
        // 处理取消逻辑，释放报表资源
        report.Close();
        report.Dispose();
        throw;
    }
    finally
    {
        report?.Close();
        report?.Dispose();
    }
}

调用时要将取消令牌传入方法：

Task loadTask = Task.Run(async () =>
{
    await GenerateReportAsync(Dispatch, reportGenerationTimeOut, cancellationTokenSource.Token);
}, cancellationTokenSource.Token);

2. 设置SQL命令执行超时（而非连接超时） #

你之前设置的Connect Timeout是数据库连接超时，而非查询执行超时。需要设置报表中每个表/命令的CommandTimeout属性：

public ReportDocument SetReportCommandTimeout(ReportDocument reportDocument, int commandTimeoutSeconds)
{
    // 设置Tables的命令超时
    foreach (Table table in reportDocument.Database.Tables)
    {
        table.CommandTimeout = commandTimeoutSeconds;
        // 同时确保登录信息正确应用
        TableLogOnInfo logOnInfo = table.LogOnInfo;
        ConnectionInfo connectionInfo = new ConnectionInfo
        {
            ServerName = logOnInfo.ConnectionInfo.ServerName,
            DatabaseName = logOnInfo.ConnectionInfo.DatabaseName,
            UserID = logOnInfo.ConnectionInfo.UserID,
            Password = "Password",
        };
        table.LogOnInfo.ConnectionInfo = connectionInfo;
        table.ApplyLogOnInfo(table.LogOnInfo);
    }
    
    // 如果报表使用了Command对象，也要设置其超时
    foreach (ReportDocument subReport in reportDocument.Subreports)
    {
        foreach (Table table in subReport.Database.Tables)
        {
            table.CommandTimeout = commandTimeoutSeconds;
        }
        foreach (Command cmd in subReport.Database.Commands)
        {
            cmd.CommandTimeout = commandTimeoutSeconds;
        }
    }
    
    foreach (Command cmd in reportDocument.Database.Commands)
    {
        cmd.CommandTimeout = commandTimeoutSeconds;
    }
    
    return reportDocument;
}

3. 使用独立进程隔离报表生成（终极方案） #

如果Crystal Reports的API完全不响应取消令牌，最可靠的方式是将报表生成逻辑放到独立的子进程中：

• 创建一个控制台应用，专门负责报表生成，接收参数（报表路径、超时时间、输出路径等）
• 主进程启动该子进程，并设置超时监控
• 超时后直接终止子进程，确保彻底停止报表生成任务
• 子进程执行完成后，将生成的报表文件或结果返回给主进程

这种方式能完全避免主进程被阻塞，且超时终止的可靠性最高。

4. 报表设计层面优化 #

• 检查报表的SQL查询是否包含不必要的大数据量返回，添加分页、过滤条件
• 确保数据库表存在合适的索引，提升查询执行速度
• 避免在报表中使用复杂的子查询或嵌套报表，减少计算量

内容的提问来源于stack exchange，提问作者Av.Raj