WebClient文件锁机制异常导致WebDAV上传PDF失败
一、故障现象
客户通过 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 相关组件
典型部署结构:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
Windows客户端 │ ├── Windows资源管理器 │ └── WebClient服务 │ │ HTTP / HTTPS ▼ Apache HTTP Server │ ├── mod_dav ├── mod_dav_fs ├── WebDAV文件锁 └── 文件系统存储目录 |
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版本
|
1 2 |
apache2 -v apache2ctl -V |
重点关注:
|
1 2 3 |
Server version HTTPD_ROOT SERVER_CONFIG_FILE |
3.2 检查Apache服务状态
|
1 |
systemctl status apache2 |
检查端口监听:
|
1 |
ss -lntp | grep -E ':80|:443' |
检查配置语法:
|
1 |
apache2ctl configtest |
正常结果:
|
1 |
Syntax OK |
3.3 检查WebDAV模块
|
1 |
apache2ctl -M | grep -Ei 'dav|logio|setenvif' |
常见模块:
|
1 2 3 4 |
dav_module dav_fs_module logio_module setenvif_module |
其中:
- dav_module:提供WebDAV核心功能。
- dav_fs_module:提供文件系统WebDAV支持。
- logio_module:支持记录HTTP输入和输出字节数。
- setenvif_module:支持根据请求条件筛选日志。
如果模块显示为(static),说明已静态编译进Apache,不需要再执行a2enmod。
对于使用动态模块的Debian安装,可以按需要启用:
|
1 2 3 4 |
a2enmod dav a2enmod dav_fs a2enmod setenvif a2enmod logio |
仅对确实存在且尚未启用的模块执行。部分自编译Apache没有对应的动态模块文件,不能直接使用a2enmod。
3.4 查找WebDAV配置
|
1 |
grep -RniE 'Dav On|DavLockDB|Alias |AuthUserFile|CustomLog' /etc/apache2/ 2>/dev/null |
重点检查:
- WebDAV是否开启。
- WebDAV URL是否正确映射到文件目录。
- 文件系统目录是否具有访问权限。
- 身份认证配置是否正确。
- WebDAV锁数据库位置是否正确。
示例:
|
1 2 3 4 5 6 7 8 9 |
Alias /webdav /srv/webdav <Directory "/srv/webdav"> DAV On AuthType Basic AuthName "WebDAV" AuthUserFile "/etc/apache2/webdav.passwd" Require valid-user </Directory> |
以上仅用于说明配置结构,不应直接覆盖现有生产配置。
3.5 检查磁盘及权限
|
1 2 |
df -h df -i |
检查目录:
|
1 2 |
ls -ld /srv/webdav namei -l /srv/webdav |
检查Apache运行用户:
|
1 |
ps -eo user,group,comm | grep -E 'apache2|httpd' |
不能仅凭目录权限为777就认为服务正常,还应检查上级目录权限、磁盘状态、挂载方式及其他安全策略。
四、开启Apache WebDAV详细调试日志
这是整个排查流程的重点。
普通Apache访问日志通常只包含IP、请求方法、状态码等信息,不足以判断文件内容是否真正发送,也不能清楚地区分创建空文件和上传完整文件。
建议单独增加WebDAV调试日志。
4.1 确认现有日志配置
|
1 |
grep -RniE 'LogFormat|CustomLog|ErrorLog|LogLevel' /etc/apache2/ 2>/dev/null |
查看虚拟主机:
|
1 |
apache2ctl -S |
需要特别注意:
如果虚拟主机内部已经配置CustomLog,仅在Apache全局配置中增加新的日志指令,不一定能让请求写入期望的日志文件。
因此,推荐将日志格式定义在全局配置中,将实际CustomLog添加到提供WebDAV的虚拟主机中。
4.2 备份配置
在修改前执行:
|
1 |
cp -a /etc/apache2/sites-enabled /root/apache2-sites-backup-$(date +%Y%m%d-%H%M%S) |
同时备份需要修改的原始配置文件。
4.3 新建日志格式配置
创建:
|
1 |
vim /etc/apache2/conf-available/webdav-debug-format.conf |
添加:
|
1 2 3 |
LogFormat "%h %u %t \"%r\" %>s duration_us=%D content_length=%{Content-Length}i transfer_encoding=%{Transfer-Encoding}i input_bytes=%I output_bytes=%O expect=\"%{Expect}i\" user_agent=\"%{User-Agent}i\"" webdav_debug SetEnvIf Request_Method "^(OPTIONS|PROPFIND|PROPPATCH|MKCOL|COPY|MOVE|LOCK|UNLOCK|PUT|DELETE)$" webdav_request |
保存后执行:
|
1 |
a2enconf webdav-debug-format |
这份配置只定义日志格式和筛选条件,还没有指定实际日志输出位置。
4.4 在WebDAV虚拟主机中启用日志
打开实际承载WebDAV的VirtualHost配置文件,例如:
|
1 |
vim /etc/apache2/sites-available/000-default.conf |
在对应的<VirtualHost>内部增加:
|
1 |
CustomLog /var/log/apache2/webdav_debug.log webdav_debug env=webdav_request |
配置结构示例:
|
1 2 3 4 5 6 7 8 9 10 |
<VirtualHost *:80> ServerName webdav.example.test DocumentRoot /var/www/html ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined CustomLog /var/log/apache2/webdav_debug.log webdav_debug env=webdav_request </VirtualHost> |
这里的webdav.example.test为示例域名。
保留原有CustomLog和ErrorLog,不要为了增加调试日志而覆盖正常访问日志。
如果一个虚拟主机承载多个应用,上述配置会记录该虚拟主机中所有匹配方法的请求。需要只监控特定WebDAV路径时,可进一步通过日志条件或路径表达式缩小范围。
4.5 配置检查与加载
|
1 |
apache2ctl configtest |
确认:
|
1 |
Syntax OK |
然后执行:
|
1 |
systemctl reload apache2 |
不建议在生产环境中未经检查直接重启Apache。
4.6 验证日志是否生效
|
1 |
tail -F /var/log/apache2/webdav_debug.log |
使用Windows资源管理器访问WebDAV映射盘。
正常情况下可能产生:
|
1 |
PROPFIND /webdav/ HTTP/1.1 207 |
再复制一个测试文件,应该看到PUT等请求。
如果没有日志,依次检查:
- 是否修改了正确的VirtualHost。
- 日志格式是否已经加载。
- CustomLog是否位于有效配置范围。
- 是否已成功reload。
- 请求是否经过其他反向代理或虚拟主机。
- 日志路径是否可写。
4.7 日志字段解释
示例:
|
1 2 3 4 5 6 7 8 9 10 |
192.0.2.10 user [01/Jan/2026:10:00:00 +0800] "PUT /webdav/test.pdf HTTP/1.1" 204 duration_us=50000 content_length=541146 transfer_encoding=- input_bytes=541400 output_bytes=151 expect="-" user_agent="Microsoft-WebDAV-MiniRedir/10.0" |
字段含义:
| 字段 | 说明 |
| %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:
|
1 |
tail -F /var/log/apache2/webdav_debug.log | grep --line-buffered '"PUT ' |
查看文件锁相关操作:
|
1 |
tail -F /var/log/apache2/webdav_debug.log | grep --line-buffered -E '"(PUT|LOCK|UNLOCK|DELETE|PROPPATCH) ' |
查看某台客户端:
|
1 |
grep '192.0.2.10' /var/log/apache2/webdav_debug.log |
查看某个文件:
|
1 |
grep -F 'test.pdf' /var/log/apache2/webdav_debug.log |
查看423、424错误:
|
1 |
grep -E '" (423|424) ' /var/log/apache2/webdav_debug.log |
对于包含中文的文件名,URL可能采用百分号编码,需要按日志里的实际URL搜索。
4.9 错误日志检查
获取Apache错误日志配置:
|
1 |
grep -Rni 'ErrorLog' /etc/apache2/ |
查看错误日志:
|
1 |
tail -F /var/log/apache2/error.log |
根据实际环境调整日志文件路径。
必要时可以临时在对应VirtualHost增加:
|
1 |
LogLevel warn dav:debug dav_fs:debug |
先执行apache2ctl configtest,再reload。
调试完成后恢复原来的LogLevel,避免长期产生大量日志。
4.10 日志关闭及回滚
如果不再需要详细日志,可删除虚拟主机中新增加的:
|
1 |
CustomLog /var/log/apache2/webdav_debug.log webdav_debug env=webdav_request |
并执行:
|
1 2 3 |
a2disconf webdav-debug-format apache2ctl configtest systemctl reload apache2 |
如其他虚拟主机仍引用该日志格式,不要禁用其定义配置。
调试日志应按需设置保留期限、访问权限及轮转策略,避免长期积累占满磁盘。
五、正常上传与异常上传日志分析
5.1 正常上传示例一:直接上传
|
1 |
PUT /webdav/test.pdf 201 content_length=541146 |
客户端一次性提交完整文件内容,Apache成功创建资源。
5.2 正常上传示例二:Windows分阶段上传
Windows WebClient可能先创建0字节文件,再上传实际内容:
|
1 2 3 4 5 6 |
PUT 201 content_length=0 LOCK 200 PROPPATCH 207 PUT 204 content_length=541146 PROPPATCH 207 UNLOCK 204 |
这种流程不一定异常。
判断依据是:
- 最终实际内容PUT成功。
- 文件大小与原文件一致。
- 客户端能够正常读取文件。
- 如使用锁,锁最终被正常释放。
5.3 异常上传:锁冲突
典型异常流程:
|
1 2 3 4 |
PUT 201 content_length=0 LOCK 200 DELETE 424 PUT 423 content_length=0 |
解释:
- 第一次PUT成功创建空文件。
- Windows成功申请WebDAV锁。
- DELETE操作因依赖条件失败而未完成。
- 后续PUT因锁条件不满足被拒绝。
- 完整文件内容没有上传,留下0KB文件。
此时Apache错误日志可能显示:
|
1 2 |
This resource is locked and an "If:" header was not supplied to allow access to the resource. |
该信息表明请求没有提供服务器要求的锁条件。
不能仅凭此日志确定客户端为什么发出了DELETE,也不能仅凭文件扩展名认定问题由某个办公软件导致。
5.4 正常上传与异常上传对照
| 项目 | 正常上传 | 锁冲突失败 |
| 首次PUT 0字节 | 可能存在 | 可能存在 |
| LOCK | 可能存在 | 通常存在 |
| 实际内容PUT | 成功 | 没有成功完成 |
| UNLOCK | 通常成功 | 可能缺失 |
| 423 | 无 | 可能出现 |
| 424 | 无 | 可能出现 |
| 最终文件大小 | 正常 | 可能为0KB |
六、检查WebDAV文件锁
6.1 定位锁数据库
|
1 |
grep -Rni 'DavLockDB' /etc/apache2/ |
常见配置:
|
1 |
DavLockDB ${APACHE_LOCK_DIR}/DAVLock |
注意:DavLockDB是Apache维护WebDAV活动锁的数据库,不能随意删除。
此外,WebDAV共享目录下可能存在.DAV隐藏目录,该目录可能保存文件属性等元数据,不应直接当作普通临时文件清理。
6.2 使用PROPFIND查询文件锁
在具备curl的Linux管理主机上执行:
|
1 2 3 4 5 6 7 8 9 10 |
curl -i --http1.1 \ -u webdav_user \ -X PROPFIND \ -H "Depth: 0" \ -H "Content-Type: application/xml; charset=utf-8" \ --data-binary '<?xml version="1.0"?> <D:propfind xmlns:D="DAV:"> <D:prop><D:lockdiscovery/></D:prop> </D:propfind>' \ "https://webdav.example.test/webdav/test.pdf" |
替换其中的域名、用户名和文件名。
响应可能包含:
|
1 2 3 4 5 6 7 8 9 10 |
<D:lockdiscovery> <D:activelock> <D:locktype><D:write/></D:locktype> <D:lockscope><D:exclusive/></D:lockscope> <D:timeout>Second-1800</D:timeout> <D:locktoken> <D:href>opaquelocktoken:example-token</D:href> </D:locktoken> </D:activelock> </D:lockdiscovery> |
重要字段:
- activelock:存在活动锁。
- write:写锁。
- exclusive:独占锁。
- timeout:剩余锁时间。
- locktoken:锁令牌。
HTTP外层返回207不代表文件无锁,应检查XML中对应属性的内部状态及activelock内容。
6.3 按条件释放文件锁
必须先确认没有其他用户正在编辑该资源,并使用有效的锁令牌及具备权限的WebDAV账户。
示例:
|
1 2 3 4 5 |
curl -i --http1.1 \ -u webdav_user \ -X UNLOCK \ -H 'Lock-Token: <opaquelocktoken:example-token>' \ "https://webdav.example.test/webdav/test.pdf" |
正常情况下可能返回:
|
1 |
HTTP/1.1 204 No Content |
如果返回401,优先检查HTTP身份认证,不要直接判断锁令牌错误。
如果锁已经过期,需重新查询,不要重复使用旧令牌。
6.4 锁问题处理注意事项
禁止在未评估的情况下执行以下操作:
- 删除整个DavLock数据库。
- 清空.DAV目录。
- 通过删除锁数据库的方式强行解除单个文件锁。
- 在有用户正在编辑时强制清理文件。
- 为修复锁冲突而直接将上传目录全部改成777权限。
应优先通过WebDAV协议查询、等待超时或按授权流程释放单个资源锁。
七、Windows客户端排查
7.1 检查Windows WebClient服务
在Windows按:
|
1 |
Win + R |
输入:
|
1 |
services.msc |
找到:
|
1 |
WebClient |
检查:
- 服务是否正在运行。
- 服务能否正常启动。
- 启动类型是否被禁用。
- 是否存在异常停止或启动失败。
已连接WebDAV映射盘且可以正常浏览目录时,WebClient通常处于运行状态。
7.2 检查客户端版本
打开:
|
1 |
Win + R → winver |
记录Windows版本、系统内部版本和更新情况。
Apache日志中的User-Agent也可辅助判断:
|
1 |
Microsoft-WebDAV-MiniRedir/10.0.19045 |
Microsoft-WebDAV-MiniRedir/10.0.19045
不同Windows版本可能存在不同的WebDAV请求行为,但不能仅凭版本判断必然存在故障。
7.3 检查WPS、Office等文件占用
若上传的文件仍在办公软件中打开,建议先关闭文件后测试。
对照测试:
| 测试 | 操作 |
| A | 文件保持打开,复制到WebDAV |
| B | 关闭文件并退出软件后复制 |
| C | 先复制为本地副本,再上传 |
| D | 使用另一台Windows电脑上传同一文件 |
如果关闭软件后仍然发生完全相同的锁冲突,应继续检查WebClient,不宜将故障直接归因于WPS或Office。
7.4 检查WebClient注册表
按:
|
1 |
Win + R → regedit |
进入:
|
1 |
计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters |
常见参数:
| 参数 | 主要作用 |
| BasicAuthLevel | Basic认证策略 |
| FileSizeLimitInBytes | 文件大小限制 |
| FileAttributesLimitInBytes | 文件属性大小限制 |
| InternetServerTimeoutInSec | Internet服务器超时 |
| LocalServerTimeoutInSec | 本地服务器超时 |
| SendReceiveTimeoutInSec | 数据收发超时 |
| SupportLocking | WebDAV锁功能支持 |
不同Windows版本、补丁或系统配置下,部分参数可能不存在,实际以当前系统为准。
八、Windows WebClient锁冲突修复方案
8.1 适用条件
仅在以下条件基本满足时,才建议尝试调整SupportLocking:
- Apache日志确认客户端存在LOCK请求。
- 后续DELETE、PUT等请求出现423或424。
- 错误日志提示资源被锁,或缺少有效If请求头。
- 已检查基本认证、目录权限、磁盘空间。
- 上传故障能够通过资源管理器重复复现。
-
已评估关闭客户端锁支持对多人编辑的影响。
8.2 备份注册表
打开注册表编辑器,定位:
|
1 |
计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters |
右键Parameters,选择“导出”,保存备份文件。
同时记录修改前的SupportLocking值。
8.3 修改SupportLocking
双击:
|
1 |
SupportLocking |
将DWORD数值从:
|
1 |
1 |
改为:
|
1 |
参数含义:
- 1:启用客户端WebDAV锁支持。
- 0:关闭客户端WebDAV锁支持。
这是针对Windows WebClient的调整,并不会关闭Apache服务器端的WebDAV锁功能。
其他客户端仍可能申请并持有WebDAV锁。
8.4 重启WebClient服务
修改完成后:
- 关闭所有正在使用WebDAV共享盘的文件。
- 打开services.msc。
- 找到WebClient。
- 重新启动服务。
- 重新连接或打开映射盘。
- 使用一个新的文件名测试上传。
这一步可能暂时中断该电脑上的WebDAV连接,建议在确认无其他文件操作后进行。
8.5 修复后的预期日志
修改前:
|
1 2 3 4 |
PUT 201 content_length=0 LOCK 200 DELETE 424 PUT 423 |
修改后可能出现:
|
1 2 3 4 5 6 |
PUT 201 content_length=0 DELETE 204 PUT 201 content_length=0 PROPPATCH 207 PUT 204 content_length=541146 PROPPATCH 207 |
这里的空文件创建和删除可能属于Windows客户端正常的分阶段处理,不应仅凭出现DELETE就判定故障。
关键是实际内容的PUT成功,且服务器最终文件大小正确。
8.6 验证方法
建议连续上传5~10个不同名称的文件。
测试内容包含:
- 不同大小的PDF。
- 中文文件名PDF。
- 英文文件名PDF。
- 之前发生故障的文件副本。
- 重复上传及覆盖场景(仅在受控测试目录进行)。
检查服务器文件大小:
|
1 |
find /srv/webdav -maxdepth 1 -type f -name '*.pdf' -printf '%f %s bytes\n' |
不能只依据Windows提示上传完成,还应验证文件能否打开、大小是否一致;重要文件建议比较SHA256校验值。
8.7 修复风险
关闭客户端WebDAV锁支持可能降低协同编辑时的冲突保护能力。
尤其需要注意:
- 多人同时修改同一文件。
- 在共享盘中直接打开并保存办公文档。
- 多台电脑覆盖同名文件。
- 依赖WebDAV锁协调写入的应用程序。
建议只对存在故障的客户端实施,不要在所有Windows电脑上批量修改。
8.8 回滚方法
如果调整后无改善,或者出现并发编辑风险,应将:
|
1 |
SupportLocking = 0 |
恢复为:
|
1 |
SupportLocking = 1 |
然后重新启动WebClient服务。
如果修改前的参数不是1,应恢复实际备份值,而非强制设置为1。
九、历史0KB文件与临时文件清理
9.1 检查0KB文件
|
1 |
find /srv/webdav -maxdepth 1 -type f -name '*.pdf' -size 0c -print |
不要直接批量删除。
因为0KB文件可能仍存在有效WebDAV锁,也可能属于正在进行中的操作。
9.2 清理前检查
需要确认:
- 文件确实为失败上传的残留文件。
- 当前没有客户端正在操作。
- 业务不再需要该文件。
- 对应WebDAV锁已经释放或过期。
- 已完成必要的备份或留证。
建议优先通过正常WebDAV客户端删除。
9.3 临时文件检查
共享目录中可能出现:
|
1 2 3 4 |
~WRD1234.tmp ~$example.docx desktop.ini Thumbs.db |
其中:
- desktop.ini和Thumbs.db通常与Windows文件夹显示有关。
- ~$文件可能与Office类程序的编辑状态有关。
- ~WRD*.tmp可能来自办公软件或其他应用的临时文件操作。
不能仅凭文件名称判断其准确来源。
可以检查:
|
1 2 |
file /srv/webdav/example.tmp stat /srv/webdav/example.tmp |
根据WebDAV日志确认上传来源:
|
1 |
grep -F 'example.tmp' /var/log/apache2/webdav_debug.log |
十、其他常见故障处理
10.1 HTTP 401
排查:
- WebDAV账户和密码。
- Apache的AuthUserFile路径。
- 客户端是否使用正确的身份凭据。
- 是否因HTTP Basic认证策略导致请求被拒绝。
401也可能是正常的认证挑战,若紧接着使用相同资源返回成功状态码,不一定构成故障。
10.2 HTTP 403
排查:
- Apache Require访问控制。
- 文件及目录权限。
- 上级目录访问权限。
- 安全模块及额外访问限制。
10.3 HTTP 404
如果请求是:
|
1 |
PROPFIND /webdav/desktop.ini 404 |
通常只是客户端检查文件是否存在,可以忽略。
如果实际业务文件返回404,则应检查路径映射、文件名编码及文件是否存在。
10.4 HTTP 417
如果curl上传时返回417,应检查:
|
1 |
Expect: 100-continue |
是否被服务器或中间代理拒绝。
这是与WebDAV文件锁不同的HTTP问题,不能因为417就直接修改SupportLocking。
10.5 HTTP 423
优先查询WebDAV活动锁及错误日志。
确认是否存在:
|
1 |
This resource is locked |
以及客户端是否满足锁令牌要求。
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 查看最新锁错误
|
1 |
grep -Ei 'locked|lock|precondition' /var/log/apache2/error.log | tail -50 |
请根据实际ErrorLog配置修改路径。
11.3 统计PUT状态
|
1 |
grep '"PUT ' /var/log/apache2/webdav_debug.log | awk '{print $6, $7, $8}' | tail -50 |
更复杂的统计应使用与实际LogFormat匹配的解析程序,不应简单假定所有日志的字段位置固定。
11.4 安全建议
建议尽可能使用HTTPS提供WebDAV服务。
HTTP Basic认证通过Base64编码传输凭据,本身不提供传输加密。
同时建议:
- 每个客户端或操作人员使用独立账户。
- 限制WebDAV上传目录的可写范围。
- 尽量限制不必要的EXE等文件类型。
- 记录用户操作和文件变更。
- 定期备份WebDAV业务文件。
- 对共享文件覆盖、删除等操作建立管理要求。
十二、总结
Windows客户端使用WebDAV映射网络磁盘时,出现上传失败、HTTP 423/424及0KB文件,并不一定是Apache权限或磁盘故障。
当Apache日志显示:
|
1 |
PUT 201 → LOCK 200 → DELETE 424 → PUT 423 |
并且错误日志提示缺少必要的If请求头时,应重点调查Windows WebClient的WebDAV锁处理行为。
在确认基础服务正常、故障可复现且经过风险评估后,可以针对故障客户端测试调整:
|
1 2 3 |
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters SupportLocking = 0 |
调整后必须重新启动WebClient服务,并通过连续上传、实际文件大小检查和文件完整性验证确认效果。
该方案属于客户端兼容性处理手段,适用于经过验证的特定故障场景。对于多人协同编辑或依赖锁机制保障数据一致性的环境,应优先保留WebDAV锁支持,继续排查客户端实现及协议兼容性问题。
最终维护原则:优先通过日志定位问题、控制修改范围、保留回滚手段,并以实际文件完整性作为最终验证依据。