ASP.NET Core平台Playwright中Bold销售订单明细报表导出功能修复咨询

下面针对导出功能（含PDF、Excel、Word等辅助格式）给出具体排查方案和代码实现：

一、核心问题定位 #

这类故障通常由以下原因导致：

• Playwright 默认拦截了文件下载请求，未正确处理Blob类型的导出响应
• Bold Report 后端导出API未完成正确配置，存在权限或跨域拦截
• Playwright 上下文未启用文件下载权限，或未等待报表内容完全渲染

二、分步解决代码与配置 #

1. Playwright 端配置：允许下载并捕获导出文件 #

需要提前监听下载事件，确保Playwright能捕获Bold Report导出的文件，示例如下：

using Microsoft.Playwright;
using System.IO;

var playwright = await Playwright.CreateAsync();
await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions
{
    Headless = false, // 调试阶段可关闭无头模式便于排查
});

// 配置上下文，启用下载并指定保存路径
var context = await browser.NewContextAsync(new BrowserNewContextOptions
{
    AcceptDownloads = true,
    DownloadsPath = Path.Combine(Directory.GetCurrentDirectory(), "ExportedReports")
});

var page = await context.NewPageAsync();

// 导航到报表页面
await page.GotoAsync("https://your-domain.com/SalesOrderReport");

// 等待报表容器加载完成（替换为你的报表容器选择器）
await page.WaitForSelectorAsync("#boldReportViewer");

// 导出PDF示例：先监听下载事件，再点击导出按钮
var downloadTask = page.WaitForDownloadAsync();
await page.ClickAsync("#export-pdf"); // 替换为页面上PDF导出按钮的选择器
var download = await downloadTask;
// 保存文件到指定路径
await download.SaveAsAsync(Path.Combine(context.DownloadsPath, "SalesOrder_Detail.pdf"));

// 导出Excel示例
downloadTask = page.WaitForDownloadAsync();
await page.ClickAsync("#export-excel");
download = await downloadTask;
await download.SaveAsAsync(Path.Combine(context.DownloadsPath, "SalesOrder_Detail.xlsx"));

2. ASP.NET Core 后端配置：确保导出服务正常 #

后端需正确注册Bold Report服务，并配置报表存储，示例如下：

// Program.cs
using BoldReports.Web;

var builder = WebApplication.CreateBuilder(args);

// 注册Bold Report服务
builder.Services.AddControllersWithViews().AddBoldReports();
// 配置报表存储（使用文件系统存储报表模板）
builder.Services.AddSingleton<IReportStorage, FileSystemReportStorage>();

var app = builder.Build();

app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

// 映射Bold Report API路由
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

// 启用Bold Report导出服务
app.UseEndpoints(endpoints =>
{
    endpoints.MapBoldReports();
});

app.Run();

自定义报表存储实现：

public class FileSystemReportStorage : IReportStorage
{
    private readonly string _reportRoot = Path.Combine(Directory.GetCurrentDirectory(), "ReportTemplates");

    public FileSystemReportStorage()
    {
        if (!Directory.Exists(_reportRoot))
            Directory.CreateDirectory(_reportRoot);
    }

    public Task<string> GetReportAsync(string reportPath)
    {
        var fullPath = Path.Combine(_reportRoot, reportPath);
        return Task.FromResult(File.ReadAllText(fullPath));
    }

    public Task<bool> SetReportAsync(string reportPath, string reportContent)
    {
        var fullPath = Path.Combine(_reportRoot, reportPath);
        File.WriteAllText(fullPath, reportContent);
        return Task.FromResult(true);
    }
}

3. 处理渲染与权限问题 #

• 等待报表完全渲染：如果导出内容依赖前端渲染，需等待页面加载完成：

  // 等待网络请求全部完成
  await page.WaitForLoadStateAsync(LoadState.NetworkIdle);
  // 或等待报表内容加载完成的标识元素
  await page.WaitForSelectorAsync(".report-render-complete");
  

• 跨域配置：若前端与报表API跨域，需添加CORS配置：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("AllowAll", policy =>
      {
          policy.AllowAnyOrigin()
                .AllowAnyMethod()
                .AllowAnyHeader();
      });
  });
  
  // 在UseRouting后启用CORS
  app.UseCors("AllowAll");
  

三、各导出格式注意事项 #

• PDF：Playwright Chromium无头模式默认支持PDF生成，无需额外配置；若导出空白，检查报表是否完全渲染
• Excel/Word：确保前后端BoldReports.Web包版本一致，避免版本兼容问题
• CSV：后端返回时需指定Content-Type为text/csv; charset=utf-8，避免乱码

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