Seafile项目WebDAV上传0字节文件问题分析与解决方案

问题背景

Seafile是一个开源的企业文件同步和共享解决方案，支持WebDAV协议访问文件。在Seafile 11版本升级后，用户报告了一个严重问题：通过WebDAV(Seafdav)上传文件时，系统会创建0字节的空文件，而不是实际的文件内容。这个问题影响了Windows、Linux和Mac三大平台的所有WebDAV客户端。

问题现象

当用户尝试通过WebDAV上传文件时：

1. Windows文件资源管理器会显示"文件太大"的错误提示
2. 最终在服务器上创建的是0字节的空文件
3. 在Linux系统上使用davfs2时，会抛出I/O错误
4. Mac系统则静默失败，同样生成0字节文件

根本原因分析

经过技术团队深入调查，发现问题源于以下几个技术层面：

1. 多进程同步问题：Seafile 11开始使用wsgidav 4.3版本，而之前版本使用wsgidav 4.1。新版本在多进程环境下存在锁管理问题。

2. gunicorn工作模式：默认配置使用5个工作进程(sync模式)，导致锁状态无法在进程间共享。当Windows客户端尝试上传时，会先发送空PUT请求，然后尝试获取LOCK，最后通过PROPPATCH发送实际内容。由于锁状态不一致，导致内容上传失败。

3. 数据库表缺失：部分用户在升级到Seafile 12后仍然遇到问题，原因是升级过程中缺少必要的数据库表(GCD和LastGCID)。

解决方案

临时解决方案(Seafile 11)

1. 修改seafdav.conf配置文件：

[WEBDAV]
enabled = true
port = 8080
share_name = /seafdav
workers = 1

2. 对于Linux davfs2用户，还需修改/etc/davfs2/davfs2.conf：

use_locks 0

永久解决方案(Seafile 12+)

1. 官方已在Seafile 12.0版本中修复了多进程同步问题。

2. 如果升级后仍遇到问题，需要手动创建缺失的数据库表：

-- 在seafile_db中执行
CREATE TABLE IF NOT EXISTS `GCD` (
  `group_id` INTEGER NOT NULL,
  `repo_id` CHAR(36) NOT NULL,
  `deleted` BIGINT NOT NULL DEFAULT 0,
  PRIMARY KEY (`group_id`, `repo_id`)
);

CREATE TABLE IF NOT EXISTS `LastGCID` (
  `repo_id` CHAR(36) NOT NULL,
  `client_id` CHAR(36) NOT NULL,
  `gc_id` CHAR(36) NOT NULL,
  PRIMARY KEY (`repo_id`, `client_id`)
);

技术细节

WebDAV协议的上传流程通常包含以下步骤：

1. PUT请求创建空文件
2. LOCK请求获取文件锁
3. PROPPATCH请求写入实际内容
4. UNLOCK释放锁

在Seafile 11中，由于多进程间锁状态不同步，导致第3步失败，最终只保留了第1步创建的空文件。而将工作进程数限制为1可以避免这个问题，因为所有请求都由同一个进程处理，锁状态保持一致。

最佳实践建议

1. 对于生产环境，建议升级到Seafile 12.0.7或更高版本
2. 升级前确保备份数据库
3. 检查并创建所有必要的数据库表
4. 监控日志文件(seafile-monitor.log)中的警告信息
5. 对于关键业务，建议先在小规模测试环境中验证WebDAV功能

总结

Seafile WebDAV的0字节文件问题是一个典型的多进程同步问题，通过理解WebDAV协议的工作流程和Seafile的架构设计，可以有效地诊断和解决这类问题。官方已在后续版本中修复了核心问题，用户只需按照建议进行升级和配置即可恢复正常使用。