一、故障现象

客户通过 Windows 10 资源管理器,将本地 PDF 文件复制到 WebDAV 映射的 磁盘,偶发文件上传失败。

主要表现为:

1. 上传文件后服务器只生成0KB文件。
2. Windows提示文件正在使用、无法访问或无法覆盖。
3. 上传过程中出现HTTP 423 Locked错误。
4. 删除文件时出现HTTP 424 Failed Dependency错误。
5. 文件在Windows资源管理器中显示存在,但实际内容没有上传成功。
6. 同一服务器上部分客户端上传正常,部分客户端上传失败。
7. 文件重复上传时提示已存在或被其他程序锁定。

故障处理原则

应优先确认问题发生在客户端、网络传输、Apache认证、文件系统还是WebDAV文件锁阶段,再选择修复措施。

本文重点介绍Windows WebClient文件锁处理异常导致的上传失败问题。

需要注意,SupportLocking=0 是一种客户端兼容性处理措施,不是Apache服务端漏洞补丁,也不代表所有WebDAV环境都应该关闭文件锁。

二、WebDAV上传工作原理

2.1 相关组件

典型部署结构:

Windows资源管理器中的网络驱动器并不等同于普通SMB共享盘。使用WebDAV映射时,Windows通常通过WebClient服务发送HTTP请求完成文件操作。

2.2 常见请求方法

HTTP方法 作用
OPTIONS 查询服务器支持的功能
PROPFIND 查询文件和目录属性
PROPPATCH 修改资源属性
PUT 创建或写入文件
LOCK 申请文件锁
UNLOCK 释放文件锁
DELETE 删除文件
MOVE 移动或重命名文件
COPY 复制服务器端资源
MKCOL 创建目录

2.3 常见状态码

状态码 含义 排查方向
200 请求成功 正常
201 资源创建成功 检查是否真正写入内容
204 请求成功,无响应内容 常见于PUT、DELETE、UNLOCK
207 Multi-Status 查看WebDAV内部属性状态
301 地址重定向 检查目录末尾斜杠
401 身份认证要求或认证失败 检查完整认证过程
403 禁止访问 检查权限
404 资源不存在 结合请求判断是否正常
409 资源状态冲突 检查目标路径及操作条件
412 前置条件不满足 检查If、If-Match等请求头
417 Expectation Failed 检查Expect请求头
423 资源被锁定 检查有效锁及锁令牌
424 依赖操作失败 查看同一时间的其他错误
500 服务器内部错误 检查Apache错误日志
507 存储空间不足 检查磁盘及配额

注意:PUT 201 不代表一定成功上传了完整文件,必须结合请求体大小及服务器实际文件大小判断。

三、服务器基础环境检查

以下以Debian/Ubuntu的APT安装方式为例。其他Linux发行版应根据实际Apache安装路径调整。

3.1 检查Apache版本

重点关注:

3.2 检查Apache服务状态

检查端口监听:

检查配置语法:

正常结果:

3.3 检查WebDAV模块

常见模块:

其中:

  • dav_module:提供WebDAV核心功能。
  • dav_fs_module:提供文件系统WebDAV支持。
  • logio_module:支持记录HTTP输入和输出字节数。
  • setenvif_module:支持根据请求条件筛选日志。

如果模块显示为(static),说明已静态编译进Apache,不需要再执行a2enmod。

对于使用动态模块的Debian安装,可以按需要启用:

仅对确实存在且尚未启用的模块执行。部分自编译Apache没有对应的动态模块文件,不能直接使用a2enmod。

3.4 查找WebDAV配置

重点检查:

  • WebDAV是否开启。
  • WebDAV URL是否正确映射到文件目录。
  • 文件系统目录是否具有访问权限。
  • 身份认证配置是否正确。
  • WebDAV锁数据库位置是否正确。

示例:

以上仅用于说明配置结构,不应直接覆盖现有生产配置。

3.5 检查磁盘及权限

检查目录:

检查Apache运行用户:

不能仅凭目录权限为777就认为服务正常,还应检查上级目录权限、磁盘状态、挂载方式及其他安全策略。

四、开启Apache WebDAV详细调试日志

这是整个排查流程的重点。

普通Apache访问日志通常只包含IP、请求方法、状态码等信息,不足以判断文件内容是否真正发送,也不能清楚地区分创建空文件和上传完整文件。

建议单独增加WebDAV调试日志。

4.1 确认现有日志配置

查看虚拟主机:

需要特别注意:

如果虚拟主机内部已经配置CustomLog,仅在Apache全局配置中增加新的日志指令,不一定能让请求写入期望的日志文件。

因此,推荐将日志格式定义在全局配置中,将实际CustomLog添加到提供WebDAV的虚拟主机中。

4.2 备份配置

在修改前执行:

同时备份需要修改的原始配置文件。

4.3 新建日志格式配置

创建:

添加:

保存后执行:

这份配置只定义日志格式和筛选条件,还没有指定实际日志输出位置。

4.4 在WebDAV虚拟主机中启用日志

打开实际承载WebDAV的VirtualHost配置文件,例如:

在对应的<VirtualHost>内部增加:

配置结构示例:

这里的webdav.example.test为示例域名。

保留原有CustomLog和ErrorLog,不要为了增加调试日志而覆盖正常访问日志。

如果一个虚拟主机承载多个应用,上述配置会记录该虚拟主机中所有匹配方法的请求。需要只监控特定WebDAV路径时,可进一步通过日志条件或路径表达式缩小范围。

4.5 配置检查与加载

确认:

然后执行:

不建议在生产环境中未经检查直接重启Apache。

4.6 验证日志是否生效

使用Windows资源管理器访问WebDAV映射盘。

正常情况下可能产生:

再复制一个测试文件,应该看到PUT等请求。

如果没有日志,依次检查:

  1. 是否修改了正确的VirtualHost。
  2. 日志格式是否已经加载。
  3. CustomLog是否位于有效配置范围。
  4. 是否已成功reload。
  5. 请求是否经过其他反向代理或虚拟主机。
  6. 日志路径是否可写。

4.7 日志字段解释

示例:

字段含义:

字段 说明
%h 客户端地址
%u 已认证的用户
%t 请求时间
%r HTTP请求行
%>s 最终HTTP状态码
%D 请求处理耗时,微秒
Content-Length 客户端声明的HTTP请求体大小
Transfer-Encoding 请求体传输编码
%I Apache接收的网络字节数,包含请求头
%O Apache发送的网络字节数,包含响应头
Expect 客户端发送的Expect请求头
User-Agent 客户端程序标识

%I不等于纯文件大小,不能直接将它视为上传内容大小。

4.8 实时过滤上传操作

只看PUT:

查看文件锁相关操作:

查看某台客户端:

查看某个文件:

查看423、424错误:

对于包含中文的文件名,URL可能采用百分号编码,需要按日志里的实际URL搜索。

4.9 错误日志检查

获取Apache错误日志配置:

查看错误日志:

根据实际环境调整日志文件路径。

必要时可以临时在对应VirtualHost增加:

先执行apache2ctl configtest,再reload。

调试完成后恢复原来的LogLevel,避免长期产生大量日志。

4.10 日志关闭及回滚

如果不再需要详细日志,可删除虚拟主机中新增加的:

并执行:

如其他虚拟主机仍引用该日志格式,不要禁用其定义配置。

调试日志应按需设置保留期限、访问权限及轮转策略,避免长期积累占满磁盘。

五、正常上传与异常上传日志分析

5.1 正常上传示例一:直接上传

客户端一次性提交完整文件内容,Apache成功创建资源。

5.2 正常上传示例二:Windows分阶段上传

Windows WebClient可能先创建0字节文件,再上传实际内容:

这种流程不一定异常。

判断依据是:

  • 最终实际内容PUT成功。
  • 文件大小与原文件一致。
  • 客户端能够正常读取文件。
  • 如使用锁,锁最终被正常释放。

5.3 异常上传:锁冲突

典型异常流程:

解释:

  1. 第一次PUT成功创建空文件。
  2. Windows成功申请WebDAV锁。
  3. DELETE操作因依赖条件失败而未完成。
  4. 后续PUT因锁条件不满足被拒绝。
  5. 完整文件内容没有上传,留下0KB文件。

此时Apache错误日志可能显示:

该信息表明请求没有提供服务器要求的锁条件。

不能仅凭此日志确定客户端为什么发出了DELETE,也不能仅凭文件扩展名认定问题由某个办公软件导致。

5.4 正常上传与异常上传对照

项目 正常上传 锁冲突失败
首次PUT 0字节 可能存在 可能存在
LOCK 可能存在 通常存在
实际内容PUT 成功 没有成功完成
UNLOCK 通常成功 可能缺失
423 无 可能出现
424 无 可能出现
最终文件大小 正常 可能为0KB

六、检查WebDAV文件锁

6.1 定位锁数据库

常见配置:

注意:DavLockDB是Apache维护WebDAV活动锁的数据库,不能随意删除。

此外,WebDAV共享目录下可能存在.DAV隐藏目录,该目录可能保存文件属性等元数据,不应直接当作普通临时文件清理。

6.2 使用PROPFIND查询文件锁

在具备curl的Linux管理主机上执行:

替换其中的域名、用户名和文件名。

响应可能包含:

重要字段:

  • activelock:存在活动锁。
  • write:写锁。
  • exclusive:独占锁。
  • timeout:剩余锁时间。
  • locktoken:锁令牌。

HTTP外层返回207不代表文件无锁,应检查XML中对应属性的内部状态及activelock内容。

6.3 按条件释放文件锁

必须先确认没有其他用户正在编辑该资源,并使用有效的锁令牌及具备权限的WebDAV账户。

示例:

正常情况下可能返回:

如果返回401,优先检查HTTP身份认证,不要直接判断锁令牌错误。

如果锁已经过期,需重新查询,不要重复使用旧令牌。

6.4 锁问题处理注意事项

禁止在未评估的情况下执行以下操作:

  • 删除整个DavLock数据库。
  • 清空.DAV目录。
  • 通过删除锁数据库的方式强行解除单个文件锁。
  • 在有用户正在编辑时强制清理文件。
  • 为修复锁冲突而直接将上传目录全部改成777权限。

应优先通过WebDAV协议查询、等待超时或按授权流程释放单个资源锁。

七、Windows客户端排查

7.1 检查Windows WebClient服务

在Windows按:

输入:

找到:

检查:

  • 服务是否正在运行。
  • 服务能否正常启动。
  • 启动类型是否被禁用。
  • 是否存在异常停止或启动失败。

已连接WebDAV映射盘且可以正常浏览目录时,WebClient通常处于运行状态。

7.2 检查客户端版本

打开:

记录Windows版本、系统内部版本和更新情况。

Apache日志中的User-Agent也可辅助判断:

Microsoft-WebDAV-MiniRedir/10.0.19045

不同Windows版本可能存在不同的WebDAV请求行为,但不能仅凭版本判断必然存在故障。

7.3 检查WPS、Office等文件占用

若上传的文件仍在办公软件中打开,建议先关闭文件后测试。

对照测试:

测试 操作
A 文件保持打开,复制到WebDAV
B 关闭文件并退出软件后复制
C 先复制为本地副本,再上传
D 使用另一台Windows电脑上传同一文件

如果关闭软件后仍然发生完全相同的锁冲突,应继续检查WebClient,不宜将故障直接归因于WPS或Office。

7.4 检查WebClient注册表

按:

进入:

常见参数:

参数 主要作用
BasicAuthLevel Basic认证策略
FileSizeLimitInBytes 文件大小限制
FileAttributesLimitInBytes 文件属性大小限制
InternetServerTimeoutInSec Internet服务器超时
LocalServerTimeoutInSec 本地服务器超时
SendReceiveTimeoutInSec 数据收发超时
SupportLocking WebDAV锁功能支持

不同Windows版本、补丁或系统配置下,部分参数可能不存在,实际以当前系统为准。

八、Windows WebClient锁冲突修复方案

8.1 适用条件

仅在以下条件基本满足时,才建议尝试调整SupportLocking:

  1. Apache日志确认客户端存在LOCK请求。
  2. 后续DELETE、PUT等请求出现423或424。
  3. 错误日志提示资源被锁,或缺少有效If请求头。
  4. 已检查基本认证、目录权限、磁盘空间。
  5. 上传故障能够通过资源管理器重复复现。
  6. 已评估关闭客户端锁支持对多人编辑的影响。

8.2 备份注册表

打开注册表编辑器,定位:

右键Parameters,选择“导出”,保存备份文件。

同时记录修改前的SupportLocking值。

8.3 修改SupportLocking

双击:

将DWORD数值从:

改为:

参数含义:

  • 1:启用客户端WebDAV锁支持。
  • 0:关闭客户端WebDAV锁支持。

这是针对Windows WebClient的调整,并不会关闭Apache服务器端的WebDAV锁功能。

其他客户端仍可能申请并持有WebDAV锁。

8.4 重启WebClient服务

修改完成后:

  1. 关闭所有正在使用WebDAV共享盘的文件。
  2. 打开services.msc。
  3. 找到WebClient。
  4. 重新启动服务。
  5. 重新连接或打开映射盘。
  6. 使用一个新的文件名测试上传。

这一步可能暂时中断该电脑上的WebDAV连接,建议在确认无其他文件操作后进行。

8.5 修复后的预期日志

修改前:

修改后可能出现:

这里的空文件创建和删除可能属于Windows客户端正常的分阶段处理,不应仅凭出现DELETE就判定故障。

关键是实际内容的PUT成功,且服务器最终文件大小正确。

8.6 验证方法

建议连续上传5~10个不同名称的文件。

测试内容包含:

  • 不同大小的PDF。
  • 中文文件名PDF。
  • 英文文件名PDF。
  • 之前发生故障的文件副本。
  • 重复上传及覆盖场景(仅在受控测试目录进行)。

检查服务器文件大小:

不能只依据Windows提示上传完成,还应验证文件能否打开、大小是否一致;重要文件建议比较SHA256校验值。

8.7 修复风险

关闭客户端WebDAV锁支持可能降低协同编辑时的冲突保护能力。

尤其需要注意:

  • 多人同时修改同一文件。
  • 在共享盘中直接打开并保存办公文档。
  • 多台电脑覆盖同名文件。
  • 依赖WebDAV锁协调写入的应用程序。

建议只对存在故障的客户端实施,不要在所有Windows电脑上批量修改。

8.8 回滚方法

如果调整后无改善,或者出现并发编辑风险,应将:

恢复为:

然后重新启动WebClient服务。

如果修改前的参数不是1,应恢复实际备份值,而非强制设置为1。

九、历史0KB文件与临时文件清理

9.1 检查0KB文件

不要直接批量删除。

因为0KB文件可能仍存在有效WebDAV锁,也可能属于正在进行中的操作。

9.2 清理前检查

需要确认:

  • 文件确实为失败上传的残留文件。
  • 当前没有客户端正在操作。
  • 业务不再需要该文件。
  • 对应WebDAV锁已经释放或过期。
  • 已完成必要的备份或留证。

建议优先通过正常WebDAV客户端删除。

9.3 临时文件检查

共享目录中可能出现:

其中:

  • desktop.ini和Thumbs.db通常与Windows文件夹显示有关。
  • ~$文件可能与Office类程序的编辑状态有关。
  • ~WRD*.tmp可能来自办公软件或其他应用的临时文件操作。

不能仅凭文件名称判断其准确来源。

可以检查:

根据WebDAV日志确认上传来源:

十、其他常见故障处理

10.1 HTTP 401

排查:

  • WebDAV账户和密码。
  • Apache的AuthUserFile路径。
  • 客户端是否使用正确的身份凭据。
  • 是否因HTTP Basic认证策略导致请求被拒绝。

401也可能是正常的认证挑战,若紧接着使用相同资源返回成功状态码,不一定构成故障。

10.2 HTTP 403

排查:

  • Apache Require访问控制。
  • 文件及目录权限。
  • 上级目录访问权限。
  • 安全模块及额外访问限制。

10.3 HTTP 404

如果请求是:

通常只是客户端检查文件是否存在,可以忽略。

如果实际业务文件返回404,则应检查路径映射、文件名编码及文件是否存在。

10.4 HTTP 417

如果curl上传时返回417,应检查:

是否被服务器或中间代理拒绝。

这是与WebDAV文件锁不同的HTTP问题,不能因为417就直接修改SupportLocking。

10.5 HTTP 423

优先查询WebDAV活动锁及错误日志。

确认是否存在:

以及客户端是否满足锁令牌要求。

10.6 HTTP 424

检查同一时间的其他错误操作。

例如DELETE返回424,同时后续PUT返回423,通常应进一步调查锁、操作依赖及客户端请求序列。

不能把所有424错误都归因为同一种原因。

10.7 文件大小不正确

重点检查:

  • PUT请求的Content-Length。
  • Transfer-Encoding。
  • HTTP最终状态码。
  • Apache实际接收到的字节数。
  • 文件系统大小。
  • 网络中断及客户端异常。

HTTP PUT成功后,还应确认实际文件完整性。

十一、日志及日常维护建议

11.1 保留日志

推荐根据业务需要设置:

  • 普通访问日志轮转。
  • WebDAV调试日志轮转。
  • 错误日志保留。
  • 特定故障期间日志备份。

不要无限期保留无轮转的调试日志。

11.2 查看最新锁错误

请根据实际ErrorLog配置修改路径。

11.3 统计PUT状态

更复杂的统计应使用与实际LogFormat匹配的解析程序,不应简单假定所有日志的字段位置固定。

11.4 安全建议

建议尽可能使用HTTPS提供WebDAV服务。

HTTP Basic认证通过Base64编码传输凭据,本身不提供传输加密。

同时建议:

  • 每个客户端或操作人员使用独立账户。
  • 限制WebDAV上传目录的可写范围。
  • 尽量限制不必要的EXE等文件类型。
  • 记录用户操作和文件变更。
  • 定期备份WebDAV业务文件。
  • 对共享文件覆盖、删除等操作建立管理要求。

十二、总结

Windows客户端使用WebDAV映射网络磁盘时,出现上传失败、HTTP 423/424及0KB文件,并不一定是Apache权限或磁盘故障。

当Apache日志显示:

并且错误日志提示缺少必要的If请求头时,应重点调查Windows WebClient的WebDAV锁处理行为。

在确认基础服务正常、故障可复现且经过风险评估后,可以针对故障客户端测试调整:

调整后必须重新启动WebClient服务,并通过连续上传、实际文件大小检查和文件完整性验证确认效果。

该方案属于客户端兼容性处理手段,适用于经过验证的特定故障场景。对于多人协同编辑或依赖锁机制保障数据一致性的环境,应优先保留WebDAV锁支持,继续排查客户端实现及协议兼容性问题。

最终维护原则:优先通过日志定位问题、控制修改范围、保留回滚手段,并以实际文件完整性作为最终验证依据。