使用urlmon.DLL下载SharePoint文件时出现损坏问题求解决方案

问题根源分析 #

• urlmon.dll的URLDownloadToFile对HTTP重定向、身份验证的处理逻辑较为老旧，SharePoint的动态链接（含重定向、权限校验）容易触发其未覆盖的边界场景，导致文件写入不完整。
• 未处理SharePoint的身份验证上下文：若文件需域账号权限，urlmon可能无法自动传递当前用户会话，导致下载的是登录页面而非实际文件。
• 缺少下载后的完整性校验，无法及时发现损坏文件。

具体解决方案 #

1. 替换为HttpClient实现（推荐，更可靠） #

放弃urlmon，改用C#原生HttpClient，它对HTTP协议的支持更完善，能更好适配SharePoint的重定向和身份验证逻辑：

using System.Net.Http;
using System.IO;

public async Task DownloadSharePointFileAsync(string sharePointUrl, string savePath)
{
    // 自动复用Windows域身份，适配企业SharePoint环境
    using var handler = new HttpClientHandler { UseDefaultCredentials = true, AllowAutoRedirect = true };
    using var httpClient = new HttpClient(handler);

    // 先获取响应头，确认请求有效
    using var response = await httpClient.GetAsync(sharePointUrl, HttpCompletionOption.ResponseHeadersRead);
    response.EnsureSuccessStatusCode(); // 请求失败直接抛出异常

    // 流式写入文件，避免内存溢出，同时强制刷新磁盘缓冲区
    using var stream = await response.Content.ReadAsStreamAsync();
    using var fileStream = new FileStream(savePath, FileMode.Create, FileAccess.Write, FileShare.None);
    await stream.CopyToAsync(fileStream);
    fileStream.Flush(true);
}

2. 修复urlmon调用逻辑（若必须保留） #

如果坚持使用urlmon，需增加错误处理和前置清理：

using System;
using System.Runtime.InteropServices;
using System.IO;

class UrlMonDownloader
{
    [DllImport("urlmon.dll", CharSet = CharSet.Auto, SetLastError = true)]
    static extern int URLDownloadToFile(IntPtr pCaller, string szURL, string szFileName, uint dwReserved, IntPtr lpfnCB);

    public bool DownloadFile(string url, string savePath)
    {
        // 先删除旧文件，避免残留不完整数据
        if (File.Exists(savePath))
            File.Delete(savePath);

        // 执行下载，0为成功，其他值对应错误码
        int result = URLDownloadToFile(IntPtr.Zero, url, savePath, 0, IntPtr.Zero);
        if (result != 0)
        {
            Console.WriteLine($"下载失败，错误码: {result}");
            return false;
        }

        // 可选：校验文件大小（需提前获取SharePoint文件的预期大小）
        return true;
    }
}

注：urlmon的错误码可参考微软官方的urlmon错误定义，若遇权限问题，需确保程序运行账号拥有该SharePoint文件的访问权限。

3. 修正SharePoint链接为直接下载地址 #

部分SharePoint路径是网页预览链接（如包含/layouts/15/WopiFrame.aspx），需替换为直接下载链接：

• 将链接中的/layouts/15/WopiFrame.aspx?sourcedoc=替换为/_layouts/15/download.aspx?SourceUrl=
• 或在SharePoint网页中右键文件选择“复制直接链接”，获取真实的文件下载URL

4. 添加文件完整性校验 #

无论用哪种下载方式，都应在下载完成后校验文件：

• 校验文件大小：从HTTP响应头的Content-Length获取预期大小，对比本地文件大小
• 校验哈希值：计算本地文件的MD5/SHA256哈希，与SharePoint文件的哈希值对比（可通过SharePoint API获取）

示例代码（校验文件大小）：

using System.Net.Http;
using System.IO;

public async Task<bool> VerifyFileSize(string url, string localPath)
{
    using var httpClient = new HttpClient { UseDefaultCredentials = true };
    var headResponse = await httpClient.SendAsync(new HttpRequestMessage(HttpMethod.Head, url));
    headResponse.EnsureSuccessStatusCode();

    if (headResponse.Content.Headers.TryGetValues("Content-Length", out var values) 
        && long.TryParse(values.First(), out long expectedSize))
    {
        return new FileInfo(localPath).Length == expectedSize;
    }
    return false;
}

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