Microsoft Graph OneDrive API：转JPG下载失败但转PDF正常问题咨询

嘿，我来帮你拆解下这个问题：你遇到的Unknown Error本质是因为OneDrive将文件转JPG时，对不同类型的源文件有额外的必填参数要求，而转PDF时不需要这些参数，所以能成功返回。下面分两种文件类型具体说明：

1. .docx 转 JPG 的必填参数缺失 #

Word文档（.docx）是多页格式，而JPG是单页格式。OneDrive没办法默认帮你决定转哪一页，所以必须指定page参数来明确要转换的页码——你当前的请求只加了format=jpg，缺少这个关键参数，导致服务抛出异常。

修正后的代码示例： #

// 获取Graph服务客户端实例
GraphServiceClient graphServiceClient = await GetGraphServiceClient();

// 定位目标docx文件
DriveItem docxItem = await graphServiceClient
    .Drive
    .Root
    .ItemWithPath("你的文件路径/xxx.docx")
    .Request()
    .GetAsync();

// 配置转换参数：必须包含format和page
List<Option> docxOptions = new List<Option>();
docxOptions.Add(new QueryOption("format", "jpg"));
docxOptions.Add(new QueryOption("page", "1")); // 指定转换第1页，可按需修改页码

// 获取转换后的JPG流
var docxJpgStream = await graphServiceClient
    .Drive
    .Root
    .ItemWithPath("你的文件路径/xxx.docx")
    .Content.Request(docxOptions)
    .GetAsync();

2. .tif 转 JPG 的注意事项 #

对于.tif文件，同样存在类似的情况：

• 如果是多页TIFF，必须添加page参数指定要转换的单页；
• 少数特殊编码的老旧TIFF可能不支持转换，但这种情况极少，优先检查是否添加了page参数。

针对tif文件的代码示例： #

List<Option> tiffOptions = new List<Option>();
tiffOptions.Add(new QueryOption("format", "jpg"));
tiffOptions.Add(new QueryOption("page", "1")); // 指定转换第1页

var tiffJpgStream = await graphServiceClient
    .Drive
    .Root
    .ItemWithPath("你的文件路径/xxx.tif")
    .Content.Request(tiffOptions)
    .GetAsync();

为什么转PDF能正常工作？ #

因为PDF转换支持直接将整个多页文档合并为一个PDF文件，不需要额外指定页码参数，所以只传format=pdf就能满足服务端的要求，自然不会报错。

另外，也可以快速确认下文件路径是否准确、你的Graph应用是否拥有Files.Read权限（不过从你能成功转PDF来看，权限应该没问题）。

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