C# 文件上传到WebDAV C#如何通过WebDAV协议上传和管理文件

WebDAV上传必须用HttpClient而非WebClient，因其支持Digest/Bearer认证、自定义请求头、连接池复用；需设BaseAddress、正确编码路径、设置Content-Type、手动处理超时与重试，并针对不同服务验证最小闭环。

WebDAV上传必须用HttpClient，别碰WebClient

WebClient在.NET Core/.NET 5+中已不支持Digest认证和自定义PROPFIND/PUT头，而多数WebDAV服务（如Nextcloud、SharePoint Online）依赖Digest或Bearer Token，直接用WebClient会卡在401且无法调试。用HttpClient才能精细控制Authorization、If-None-Match等头，也方便复用连接池。

• 初始化HttpClient时设BaseAddress为WebDAV根URL（如https://dav.example.com/remote.php/webdav/），避免每次拼接
• 手动添加Authorization：Basic Base64(user:pass)，或从OAuth2获取的Bearer xxx
• 上传前建议先HEAD请求目标路径，检查是否已存在，避免覆盖——WebDAV本身不保证幂等

PUT上传文件要设Content-Type，否则Nextcloud会拒收

Nextcloud、OwnCloud等对Content-Type敏感；传application/octet-stream最安全，但若传text/plain却发二进制内容，服务端可能截断或报500。注意：不是所有WebDAV服务都校验这个，但漏设是常见400原因。

• 用ByteArrayContent或StreamContent封装文件数据
• 显式调用content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream")
• 如果目标路径含中文或特殊字符（如报告-2024.xlsx），必须用Uri.EscapeDataString()编码路径，不能只靠Uri.EscapeUriString()

删除/重命名需用MOVE和DELETE，PROPFIND查元数据

WebDAV没有“rename”方法，重命名本质是MOVE请求，Destination头必须是绝对URL（含协议和域名），相对路径会被忽略。删文件用DELETE，但某些服务（如Synology DSM）要求先PROPFIND确认存在，否则返回404而非405。

• MOVE请求必须带Destination头，值如https://dav.example.com/remote.php/webdav/新名.pdf
• DELETE响应码204表示成功，404表示不存在——别当成失败处理
• PROPFIND体里放最小XML：，避免全量属性拖慢响应

超时和重试必须自己加，WebDAV没内置机制

WebDAV操作常因网络抖动或服务端限流失败（尤其大文件上传），但HttpClient默认无重试，超时默认100秒也不够传百兆文件。不处理会导致上传中途静默失败。

• 设置HttpClient.Timeout = TimeSpan.FromMinutes(10)，别用默认值
• 对PUT/MOVE这类非幂等操作，仅对5xx和连接异常重试；4xx（如409 Conflict）直接抛出
• 用Polly库最省事：Policy.HandleResult(r => !r.IsSuccessStatusCode && r.StatusCode >= 500).WaitAndRetryAsync(3, _ => TimeSpan.FromSeconds(2))

WebDAV路径权限、锁机制、分块上传支持度因服务而异，同一套代码在Nextcloud能跑，在SharePoint可能卡在OPTIONS预检——实际部署前，务必拿目标环境的真实URL跑通PROPFIND + PUT + DELETE最小闭环。