Picoshare项目中文件过期时间显示问题的技术解析

在开源文件分享项目Picoshare中，开发团队发现了一个关于文件过期时间显示的技术问题。当用户上传文件并设置文件生命周期为"永不过期"时，系统在前端界面错误地显示了"36500天"而非"永不过期"的标识。

问题背景

Picoshare是一个轻量级的文件分享服务，允许用户上传文件并设置不同的过期时间。其中有一个特殊选项是"永不过期"，理论上应该在前端界面显示为"Never"。然而，在实际运行中，系统却将这类文件显示为将在36500天后过期。

技术原因分析

经过代码审查，发现问题根源在于系统内部对"永不过期"这一概念的处理不一致。在代码实现中：

1. 系统使用FileLifetimeInfinite常量表示永不过期的文件
2. 但实际存储时，系统将其转换为当前时间加上很长一段时间(36500天)的日期
3. 前端显示逻辑没有特殊处理这种情况，直接计算并显示了剩余天数

这种实现方式导致了显示上的不一致，虽然功能上文件确实长期有效，但用户体验上不够直观。

解决方案设计

开发团队提出了多层次的解决方案：

1. 核心逻辑修改：在FileLifetime.ExpirationFromTime方法中添加特殊处理，当遇到FileLifetimeInfinite时返回NeverExpire常量
2. 测试保障：
   • 添加单元测试验证核心逻辑
   • 扩展端到端测试覆盖前端显示验证
3. 时间处理优化：引入Clock接口模拟时间，使测试更可靠

实现细节

在具体实现上，团队进行了以下关键修改：

1. 修改了文件生命周期计算方法，确保永不过期文件统一返回一个特殊日期
2. 重构了测试用例，不再依赖辅助函数convertExpirationTimeToFileLifetime
3. 使用Playwright添加前端验证，确保表格中正确显示"Never"
4. 引入时间模拟机制，使测试不受实际系统时间影响

技术挑战

在解决过程中，团队遇到了几个技术难点：

1. 测试复杂性：端到端测试需要处理用户权限差异(普通用户vs管理员)
2. 时间处理：确保测试在不同时间运行时结果一致
3. 前后端一致性：保证核心逻辑修改不会影响其他功能

最佳实践总结

通过这个问题的解决，我们可以总结出几个值得借鉴的开发实践：

1. 特殊值的处理应该在整个系统中保持一致
2. 测试应该验证实际业务需求，而不仅是代码实现
3. 时间相关逻辑应该设计为可测试的
4. 端到端测试需要覆盖用户视角的所有关键路径

这个案例展示了如何在开源项目中处理显示逻辑与业务逻辑的一致性问题，同时也体现了良好的测试驱动开发实践。