排障问答
报错先查表：状态码 → 含义 → 对策。#
| 状态码 | 文案关键词 | 含义与对策 |
|---|---|---|
| 400 | KV 存储不支持超过 20MB | 换 R2 / B2 / 外部盘 |
| 400 | MEGA API 模式单文件上限 64MB | 改 WebDAV 中转或换 R2 / B2 |
| 400 | Zoho 直传超过 100MB | 切续传模式后重试；免费版仍受 Zoho 侧 1GB 单文件墙 |
| 400 | 文件超过 20MB 无法存储（匿名上传） | 绑定 R2 或启用 B2 |
| 400 | 超过限制（最大 5GB） | 项目硬顶，拆分文件 |
| 400 | S3 Endpoint / 密钥 / 桶名相关 | Endpoint 补 https://、桶名大小写、Region 留空自动解析后重试 |
| 400 | WebDAV 地址 / 账密相关 | pCloud 注意美欧区地址、Koofr 必须用应用专用密码、InfiniCloud 节点名去 My Page 查 |
| 413 | 账户配额不足（已用 XMB，上限 YMB） | 该外部账户累计额度用完：调高其独立配额（-1=无限）或删其文件 |
| 413 | 存储空间不足（全局限额已满） | 该后端 quota_cap_* 用完：管理后台调高或清理该后端文件 |
| 413 | 边缘 Request entity too large | 撞 100MB 平台请求体墙：改 R2 MPU / 预签名直传 / Zoho 续传 |
| 413 | Zoho 侧 >250MB | 普通接口拒收，走续传（大文件）接口 |
| 429 | 今日写入量已达上限（KV） | KV 写次数（1000/天）用完，次日 00:00 UTC 恢复，或改 R2 |
| 429 / 403 | Google Rate limit exceeded | 撞 750GB 日上传或 API 配额，等 24h + 指数退避 |
| -18 / -22 | MEGA 报错 | -18 传输配额用尽（等恢复 / 升级 Pro）；-22 存储满（删文件 / 升级） |
| -16 | MEGA EBLOCKED | 临时封禁：停一切登录 2–24h，见 MEGA 防封 |
| 507 / 509 | Zoho / WebDAV 空间满 | 组织 / 个人空间满：升级套餐、加购空间 |
| 500 | D1 绑定缺失 | 绑定变量名写错，改成大写 DB，见 手动部署 B.4 |
常见问题
不报错，但不对劲。#
会话过期被踢回登录，是号被盗了吗？
正常。后台轮询不踢人，只有会话自然过期会踢，登录后自动回到原目录。
目录加载失败怎么办？
点「重试」；仍失败看 GET /api/health 的 db / kv / r2 / lastCronAt，逐项排查绑定与 Cron。
删掉的文件，下次同步又冒出来了？
2026-10 中旬已修：现在是真删，不会再回来。如果还出现，先确认 Cron 心跳正常（cronStale=false）。
关页后速度变慢，是 bug 吗？
不是。开页轮询一直在推进，关页后只剩 Cron 每分钟一次。用管理后台的保活 Token + 外部定时器每 30–60s 调 /api/jobs/pump，速度接近开页。详见 后台任务。
免费计划够用吗？
个人用够。三块天花板：Worker 请求体 100MB（大文件走直传/MPU 绕开）、KV 写 1000 次/天、D1 单库 500MB（只存元数据，碰不到）。详见 上限对照。
分享链接安全吗？
token 存哈希不存原文；密码 ≥8 位；过期最长 5 年；输错多次锁定；每条链有统计，可随时撤销。下载 ticket 只有 1 小时有效期。
升级会丢数据吗？
不会。脚本加 --upgrade 只覆盖代码；手动重贴 worker-single.js 即可。数据库启动时自动迁移。详见 升级。
更新日志
最近变了什么。#
能存的地方到 8 种（新增 B2 / S3 / WebDAV / MEGA）；星标收藏、标签、批量重命名（≤100）、最近上传、搜索定位到目录；复制/移动变后台任务（≤500/批），GDrive 公开文件夹一键拉取（单次/定时）；保活 pump + Cron 优先级；大文件分片续传扩大到 B2/S3；MEGA 浏览器直连下载；同步间隔 5–120 分钟可调；分享加访问统计；删了的东西不再冒出来；文本编辑改为直接覆盖保存，不再保留历史版本。
图片灯箱、音视频直播、PDF 内嵌、文本在线改；按类型/时间/收藏/标签筛，列表无限滚动；一文件多分享链接；新增"复制到…"；上传冲突二选一、下载单文件重试；中文文件名修复；移动可新建文件夹。
多用户/注册/邀请码/共享空间下线，只剩一个 owner（无限配额）；首次打开创建账号；首页变盘符视图；数据库自动迁移，老管理员直接沿用。
v2.93 备份/导出（v3.0 下线）；v2.921 上传改"只拦截危险格式"；v2.92 修下载文件名；v2.91 修同步卡死；v2.90 首个正式版。
技术附注：程序版本 3.0.0，数据结构 v26，升级时自动迁移，无需手动建表。