“帮我看看,我那份到底交上去没有?”
期末前那几周,这句话在班群和私聊里出现的频率,大概仅次于“在吗”。每次轮到收一个班的实验报告或者大作业压缩包,负责汇总的同学都得在群里喊好几轮。有人把文件名写成“最终版2.zip”,有人卡着半夜十二点的截止线,在校园网里转圈转得满头大汗,连点三下提交,然后来问上面那句话。
几乎所有文件收集工具的首页都长得差不多:居中一行醒目的标题,底下一段格式说明,再摆一个大大的“选择文件”按钮。如果只做个演示原型,能把本地文件塞进表单发出去,就算齐活了。可真拿它去收一个班的作业或几十份项目材料,麻烦往往在按下按钮之后才刚露头:到底是谁在几点几分交了哪个版本?几十兆的压缩包有没有完完整整落到硬盘上?过了截止日期,甚至隔了小半年,这批文件还能不能清清楚楚地翻出来对账?
折腾云集(Idrop.in)的那段日子,我经常深夜拿张草稿纸,把这条看似简单的链路拆开重捋。一个正经的收集任务得有明确的截止时间和实时的提交统计;上传要支持按 5 MB 切片、断点续传和秒传;存储后端要在 MinIO、七牛云和服务器本地磁盘之间随时切换;后台还得稳稳兜住权限隔离、操作审计和回收站。至于后来顺手加上的 AI 自动批阅和统计图表,反倒只是锦上添花的挂件,绝不能喧宾夺主,遮住文件本身从生到死的那一整段生命周期。
切片之后,上传变成了一场接力
真动手写分片上传,后端的整个处理逻辑都变了味。一个大文件递过来,不再是一锤子买卖的单次请求,而是一串碎片:随时可能因为校园网抖动而重试,可能乱序到达,也可能重复提交。现实里总有人性急连点两下提交按钮,或者手机浏览器切到后台崩溃恢复时把同一个分片再发一遍。(我自己拿手机在宿舍阳台上测弱网的时候,就干过好几回这种事。)
服务端要是傻乎乎地把每次请求都当成新东西,底下的账本立刻乱套。它得老老实实维护上传会话,拿任务标识、文件标识和分片编号去做幂等判断,逐个核对分片的序号与内容摘要,确认所有拼图一块不少地躺齐了,才敢动手合并。前端页面也不能光看最后一个分片返回了状态码,就急着弹出“上传完成”的绿勾;必须等后端合并完、稳稳落了盘、元数据写进数据库,那一声“交上了”才算真正作数。
顺着分片往下做,断点续传和秒传里也藏着不能糊弄的细节。传到一半断了网,页面上的进度条只是个心理安慰,重连之后客户端必须先去问服务端:“你那边到底实打实收到了哪几片?”绝不能拿本地内存里的旧进度当真。做秒传时,虽然靠比对文件哈希摘要就能认出对象存储里已经有一份一模一样的文件,省去重复传输的工夫,但后端依然得老老实实为当前这个收集任务新建一条独立的提交记录。
我第一版就在这儿偷了懒,连记录都省了。结果测试时闹出一个让人哭笑不得的乌龙:服务器里明明有这个文件,交作业的人在列表里怎么也找不到自己的名字。
存储切换与异步批阅
文件存稳了,权限隔离与存储引擎切换又是另一道容易踩空的坎。
发起收集的人、来交文件的人、守在后台的管理员,各自能看到的界面和能做的操作截然不同。更要紧的是,对象存储生成的公开访问地址,绝不能直接当成业务层面的权限凭证发出去。临时下载链接、管理接口、操作日志,都得分别卡死有效期、角色归属,还得具备随时撤销的能力。
我又想让 Idrop.in 支持在运行时动态切换存储后端,这就逼着业务层在写数据库表时,绝不能把某一家云厂商特有的路径格式写死在字段里。从日常上传、任务过期后的自动归档,到扔进回收站和彻底销毁,每一步都必须穿过同一层存储抽象接口,不然用不了多久,云端桶里就会堆满谁也认领不了的孤儿文件。一个文件在任务截止后进了回收站,也并不意味着它瞬间从所有 CDN 缓存和底层存储里彻底蒸发了;只有把整段生命周期明明白白写进状态记录,哪天碰上有人误删或者重复交稿,翻开后台才能一五一十讲清楚来龙去脉。
至于后来接进来的 AI 批阅,我从一开始就当成纯粹的异步活计来对待。用户把文件交上来,系统头一件事是立刻给出一张干脆利落的收据,让人安心关掉网页去干别的;后面的模型打分、维度雷达图、通过 SSE 慢慢推过来的批改进度,晚几秒甚至几分钟都无所谓。外部模型接口万一抽风报错,原本交上来的文件照样好好躺在任务列表里,管理员随时点一下重试,或者干脆自己动手批改。
要是贪图代码写起来顺手,直接把又慢又脆的模型调用塞进上传的主链路,那外部接口任何一次抖动,都会演变成整个收集系统的瘫痪。这个念头我动过,好在没真那么干。
按钮背后的三台状态机
把这个项目一点点啃下来之后,再看网页上那些平平无奇的上传表单,我脑子里浮现出来的往往是三台紧紧咬合在一起的状态机:收集任务在草稿、开放、截止和归档之间流转;每次提交在上传中、待合并、已完成和失败之间跳动;底下的物理文件则经历着存在、回收与彻底删除的更替。
挺有意思的是,一旦把状态转换的条件和异常时的退路在草稿纸上画清楚,前端页面写起来反而格外清爽。底层的状态要是一团浆糊,页面上的统计图表画得再花哨,也不过是在给混乱涂脂抹粉。
合上电脑时,对面宿舍楼的灯已经熄了大半。说到底,做一个文件收集工具从来不在于把上传按钮画得多大、动效调得多顺滑。真正让人踏实的,是让每一份交上来的文件在任何时候都能找得到、说得清来龙去脉、能体面地撤回,也能在半路出错时从容地接上。
眼下 Idrop.in 留在仓库里的还只是一副正在慢慢长肉的骨架,可那些深夜调试里一点点摸透的脾气,大概比页面上那枚绿色的成功图标更让我觉得珍贵。下次班里再收作业,我想试试让大家用它交。至少那句“我那份到底交上去没有”,可以让它来回答。