ASP.NET Core中FileStream与FileResult返回PDF结果异常问题

核心问题分析 #

出现无效PDF或空文件的原因通常是流位置未重置、PDFFlow写入未完成，或是错误返回了未生成完成的对象而非流内容。以下是具体解决步骤：

1. 确保PDFFlow完成写入并重置流位置 #

PDFFlow写入MemoryStream后，必须完成文档生成流程，再将流的读取位置重置到起始点，否则读取时会从流末尾开始，导致内容为空。

示例ASP.NET控制器代码：

public IActionResult DownloadPdf()
{
    using var memoryStream = new MemoryStream();
    
    // 初始化PDFFlow文档并添加内容
    var document = DocumentBuilder.New();
    document.AddSection()
            .AddParagraph("PDFFlow生成的PDF内容")
            .AddParagraph("测试段落");
    
    // 将文档生成到MemoryStream（确保调用Build/Generate完成写入）
    document.Build(memoryStream);
    
    // 重置流位置到起始点，否则FileResult会从末尾读取空内容
    memoryStream.Position = 0;
    
    // 返回有效PDF文件
    return File(memoryStream, "application/pdf", "result.pdf");
}

2. 返回字节数组的正确方式 #

若选择返回stream.ToArray()，无需手动重置位置（ToArray()会读取整个流的内容），但仍需确保PDFFlow已完成写入：

public IActionResult DownloadPdfBytes()
{
    using var memoryStream = new MemoryStream();
    var document = DocumentBuilder.New();
    document.AddSection().AddParagraph("字节数组方式返回");
    
    document.Build(memoryStream);
    var pdfBytes = memoryStream.ToArray();
    
    return File(pdfBytes, "application/pdf", "bytes_result.pdf");
}

3. 异步场景的处理 #

如果使用PDFFlow的异步生成API，需确保await完成写入操作：

public async Task<IActionResult> DownloadPdfAsync()
{
    using var memoryStream = new MemoryStream();
    var document = DocumentBuilder.New();
    document.AddSection().AddParagraph("异步生成PDF");
    
    await document.BuildAsync(memoryStream);
    memoryStream.Position = 0;
    
    return File(memoryStream, "application/pdf", "async_result.pdf");
}

4. 排查[object Object]无效内容 #

这种情况是因为错误返回了PDFFlow的文档对象而非生成后的流/字节数组，务必确保控制器方法返回的是FileResult类型，而非直接返回document或未处理的对象。

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