彻底解决 NocoBase 文件上传大小限制：从 20MB 报错到 500MB 大文件上传一步到位

彻底解决 NocoBase 文件上传大小限制：从 20MB 报错到 500MB 大文件上传一步到位

【免费下载链接】nocobaseNocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase

上传 50MB 的视频到 NocoBase，页面要么转很久，要么直接报 400 失败——问题几乎都出在 NocoBase 文件上传大小限制上。这篇文章就从这个真实的失败场景切入，讲清楚如何判断是哪一层在卡你、如何分步完成 NocoBase 上传文件限制配置，以及 NocoBase 分块上传如何支撑稳定的 NocoBase 大文件上传。

🎯 上传到 20MB 就失败？先判断是哪一层在卡你

文件要落地，要依次过三道门，卡你的可能不止 NocoBase 本身：

• 应用层：文件管理插件按存储规则里设置的上限校验大小，超限直接返回 400，错误信息通常写得很明确。
• 网关层：NocoBase 前面的 Nginx 或云负载均衡也有请求体大小限制（Nginx 里那个指令叫client_max_body_size），超了会返回 413，甚至连接直接断掉、NocoBase 日志里根本看不到这次请求。
• 云存储服务商层：阿里云 OSS 等服务对单个对象大小有自己的上限，应用层放行了，最后一步还是可能被它拦下。

判断依据很直接：拿到明确的 400 报错，先查应用层；413 或者请求石沉大海，查网关；NocoBase 日志显示上传已完成但服务商报错，查服务商文档。

📐 如何把 NocoBase 上传上限提到 500MB

应用层默认只有 20MB，这个数字来自文件管理器插件源码中的核心常量FILE_SIZE_LIMIT_DEFAULT（20 乘以 1024 再乘以 1024 字节），同时定义了最小值 1 字节，理论上最大没有封顶——所以 20MB 只是默认值，不是硬上限。

后台操作路径：登录管理后台，进入 文件管理 → 文件存储，点开当前在用的那条存储记录，把文件大小上限（size）改为目标值，例如 500MB，保存即可。注意这个值是按存储设置的，改了 A 存储不影响 B 存储。

☁️ 本地存储与阿里云 OSS、S3、腾讯云 COS 的限制配置差异

四种存储共用同一套规则字段，但限制真正生效的位置不同：

• 本地存储：上限完全由应用层把关，文件写入服务器本地storage/uploads目录。最简单，但大文件受磁盘容量和单条上传链路速度制约，是最容易先卡住的一层。
• 阿里云 OSS / AWS S3 / 腾讯云 COS：文件流式直传对象存储，客户端超时内置了 600 秒，size规则仍在 NocoBase 侧先校验一次，之后由服务商的单个对象上限兜底——通常是 GB 级别，远宽于应用层默认值。

实践含义：云存储场景多数情况不必急着调大 size，瓶颈往往在网关；本地存储则只要想传大文件，第一件事就是调这条规则。

🧩 NocoBase 大文件上传为什么需要分块上传

一次性上传意味着整个 500MB 文件走一条连接传到底：中途网络抖动就全部重来，而且很容易撞上网关的超时上限。分块上传的思路是客户端把文件切成若干小块，逐块传给服务端再合并——每块小、传得快，某一块失败只需重传那一块，进度也可视化。对于动辄几百 MB 的场景，这基本是必选项而不是可选项。

还有个容易忽略的细节：NocoBase 收到文件后会先读取开头约 4100 字节来识别真实文件类型（MIME，可以理解为文件的"身份证"），扩展名伪装成图片的可执行文件会被规则拦下。所以上限放得越大，类型规则越不能省。

🔐 放大了上传上限，配套要收紧权限与类型规则

大文件风险更高，三件事建议一起做：

• 谁能看到：文件入库后由权限体系控制哪些角色可浏览、下载，敏感文件不要放任全员可见。
• 能传什么：存储规则支持按 MIME 列表限定允许的类型，放大 size 时顺手收紧类型白名单，两条规则配套。
• 单文件原则：当前一次上传请求只接受一个文件，多文件需求需要多次提交。

另外记得定期看本地存储的磁盘占用，大文件传多了，空间比带宽先见底。

✅ 验证 NocoBase 文件上传限制配置是否生效

准备三个测试文件：略小于新上限的、超上限的、类型不在白名单里的，依次上传，预期结果分别是成功、400 提示超大小、400 提示类型不允许。如果第一个文件拿到 413，说明应用层改了但网关没改，回头去调网关的请求体上限。全部通过后，再到文件集合里确认记录生成、预览地址可正常访问。具体字段和界面可对照文件管理官方文档。

先做一件就能推进的事：打开 文件存储，看一眼当前存储的 size 到底是多少。它决定了你的 500MB 文件是今天就能传，还是要先动网关再动配置。

【免费下载链接】nocobaseNocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase