Telerik RadPdfViewer无法加载Azure Blob存储PDF文档求助

我来帮你梳理几个实用的排查方向，你可以一步步验证，定位问题所在：

1. 先确认Blob读取的PDF内容是否有效 #

首先得排除“Blob本身读取就有问题”的可能性。你可以把PreviewBlob方法返回的字节数组，临时保存到本地成PDF文件，手动打开看看能不能正常显示：

var pdfBytes = PreviewBlob("你的BlobUri");
// 保存到本地测试
File.WriteAllBytes(@"C:\temp-test.pdf", pdfBytes);

如果这个本地文件打不开，那问题根源在Blob读取环节，重点检查：

• PreviewBlob里是否完整读取了Blob流？比如是否调用了DownloadToByteArray、或者用OpenRead()后完整读取了所有字节，有没有遗漏流的重置操作；
• 检查目标Blob的ContentType是否设置为application/pdf（虽然不是强制要求，但部分组件会依赖这个标识判断文件类型）。

2. 检查RadPdfViewer的加载逻辑是否正确 #

RadPdfViewer加载PDF的方式需要匹配你的项目类型，确保调用了正确的API：

如果你用的是WPF版本： #

var pdfBytes = PreviewBlob("你的BlobUri");
// 每次加载都要创建新的MemoryStream，避免流位置到末尾导致读取失败
using (var stream = new MemoryStream(pdfBytes))
{
    radPdfViewer.LoadDocument(stream);
}

如果你用的是Web端（ASP.NET Core/MVC）： #

后端需要返回正确的文件结果，前端Viewer配置对应数据源：

// 后端控制器方法
public IActionResult GetBlobPdf()
{
    var pdfBytes = PreviewBlob("你的BlobUri");
    return File(pdfBytes, "application/pdf", "preview.pdf");
}

然后在前端绑定Viewer的DocumentSource到这个接口地址。

关键提醒：不要重复复用同一个流实例，每次加载都要新建流，因为流读取后指针会到末尾，不重置的话后续读取会返回空内容。

3. 排查Web场景的权限/跨域问题 #

如果是Web项目，额外检查：

• Azure Blob的CORS规则是否允许你的网站域名发起请求；
• 私有Blob是否配置了正确的访问权限：比如是否用了SAS Token、Managed Identity来授权读取，避免返回403/404导致的空流。

4. 抓取RadPdfViewer的错误信息 #

很多时候组件会抛出异常但没有直观显示，你可以监听错误事件获取细节：

• WPF场景：订阅DocumentLoaded事件查看错误

radPdfViewer.DocumentLoaded += (sender, args) =>
{
    if (args.Error != null)
    {
        Console.WriteLine($"PDF加载失败：{args.Error.Message}\n{args.Error.StackTrace}");
    }
};

• Web场景：打开浏览器控制台，查看是否有JS报错、网络请求失败的日志。

5. 验证RadPdfViewer本身的基础功能 #

先跳过Azure Blob，直接加载本地PDF测试组件是否正常工作：

var localPdfBytes = File.ReadAllBytes(@"C:\本地测试文件.pdf");
using (var stream = new MemoryStream(localPdfBytes))
{
    radPdfViewer.LoadDocument(stream);
}

如果本地文件能正常显示，那问题肯定出在Azure Blob的读取/传递环节；如果本地也不行，可能是RadPdfViewer的组件依赖缺失、版本不兼容，或者项目配置有问题。

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