NuGetGallery上传功能故障排查与解决方案

问题背景

在使用NuGetGallery自托管版本时，开发人员遇到了一个影响核心功能的问题：当用户在上传页面取消包上传操作后，系统会进入无法继续上传的状态。具体表现为系统错误提示"无法上传文件，因为已有上传正在进行中"，即使尝试上传不同版本的包也无法解决。

问题现象分析

根据用户描述，问题复现步骤如下：

1. 用户启动一个全新的NuGetGallery部署
2. 配置SQL Express数据库并应用迁移
3. 通过IIS部署网站
4. 注册新用户并尝试上传.nupkg包
5. 在上传过程中点击"取消"按钮
6. 之后任何上传尝试都会失败并显示错误信息

从技术角度看，这表明系统在上传取消后未能正确清理上传状态，导致后续操作被错误地阻止。

根本原因

经过深入分析，发现问题出在文件系统权限配置上。具体表现为：

1. NuGetGallery在上传过程中会在App_Data/Files/uploads目录创建临时文件
2. 当上传被取消时，系统需要删除这些临时文件以释放上传状态
3. 原始配置中IIS应用程序池账户只有"读取"和"写入"权限
4. 缺少"完全控制"权限导致系统无法删除临时文件
5. 残留的临时文件使系统误认为仍有上传在进行

解决方案

解决此问题的方法很简单但有效：

1. 定位到NuGetGallery部署目录下的App_Data/Files/uploads文件夹
2. 右键点击文件夹选择"属性"，进入"安全"选项卡
3. 找到IIS应用程序池使用的账户（通常是IIS_IUSRS或特定应用程序池标识）
4. 为该账户添加"完全控制"权限
5. 确认更改并重启IIS服务

技术启示

这个问题为我们提供了几个重要的技术启示：

1. 权限配置完整性：在Web应用程序部署中，不仅要考虑读写权限，还需要考虑删除等操作的权限需求。

2. 临时文件管理：文件上传功能实现时，应该确保有完善的临时文件清理机制，包括异常情况和用户取消操作时的处理。

3. 错误信息设计：系统错误信息虽然指出了问题现象，但未能直接提示可能的权限问题，这提示我们在设计错误处理时可以考虑更详细的诊断信息。

4. 部署检查清单：建议为NuGetGallery部署创建详细的权限检查清单，特别是对于需要文件系统操作的组件。

最佳实践建议

基于此问题的解决经验，建议NuGetGallery管理员和开发人员：

1. 在部署前全面检查应用程序所需的所有权限
2. 为上传功能配置专用的存储位置，并设置适当的权限
3. 考虑实现上传超时机制，自动清理长时间未完成的临时上传
4. 在文档中明确记录文件系统权限要求
5. 对于生产环境，考虑实现更完善的日志记录，帮助诊断类似问题

总结

这个NuGetGallery上传功能的问题典型地展示了权限配置不完整可能导致的系统行为异常。通过正确配置文件系统权限，特别是确保应用程序有足够的权限来管理它创建的文件，可以有效解决这类问题。这也提醒我们在部署Web应用程序时要全面考虑各种操作场景下的权限需求。