Layui的size参数仅前端校验，单位KB，文件超限时不发请求；若≤size仍报413，说明Nginx或后端限制未同步调整，需配置client_max_body_size及post_max_size等参数。
layui 的 size 参数只拦前端，不防 413
它只是个纯 js 校验，单位是 kb；设 size: 2048 意味着文件 > 2mb 时，layui 根本不发请求，直接触发 choose 或 before 回调。但若文件 ≤ 2mb，却仍被后端或 nginx 返回 413，说明问题出在服务端限制——此时请求已发出，size 完全无效。
常见误操作：只改了 layui 的 size，以为万事大吉，结果上传 1.9MB 文件仍报错。
- 前端校验是第一道防线，不能替代服务端配置
-
size值必须和后端实际允许上限对齐，否则用户会困惑“明明没超，为什么失败” - 建议把
size设得略小于服务端限制（比如服务端允 50MB，前端设 48MB），留出 header、form 字段等额外开销余量
error 回调里怎么识别真 413？别只看 data.status === 413
浏览器 XMLHttpRequest 的 status 在跨域或代理拦截时经常为 0，尤其遇到 Nginx 或 Cloudflare 直接拦截 413，data.status 很可能不是 413，而是 0 —— 但响应体（data.responseText）里通常含 "Payload Too Large" 或 "Request Entity Too Large"。
正确判断逻辑应组合多个信号：
-
data.status === 413→ 明确服务器返回 -
data.status === 0 && data.readyState === 4 && /entity too large|payload too large/i.test(data.responseText)→ 极大概率是 Nginx/CDN 拦截 - 配合浏览器 Network 面板确认真实状态码，不要只信 console.log(data)
示例片段：
error: function(data) {
const is413 = data.status === 413 ||
(data.status === 0 && data.readyState === 4 &&
/entity too large|payload too large/i.test(data.responseText || ''));
if (is413) {
layer.msg('文件过大，请上传小于 ' + (this.size || 2048) + 'KB 的文件');
return;
}
layer.msg('上传失败，请检查网络或重试');
}
Nginx 的 client_max_body_size 必须写在具体 location 块里
很多团队只在 http 或 server 块里加了 client_max_body_size 100m，但依然 413——因为更内层的 location 块没覆盖，用了默认 1MB。Layui 上传请求走的是你配的 url，比如 /api/upload，那这个路径对应的 location 才是生效位置。
- ✅ 正确写法：
location /api/upload { client_max_body_size 200m; } - ⚠️ 错误写法：只在
http块设，但location /块里没声明，或写了client_max_body_size 1m覆盖了它 - 修改后务必执行
nginx -t验证语法，再nginx -s reload生效 - 如果用了
proxy_pass，后端框架（如 Laravel 的post_max_size、Express 的limit）也得同步调大，且 ≥ Nginx 设置值
上传大文件时后端收不到其他字段？不是 413，是 multipart 解析失败
这是高频隐藏坑：文件本身没超限，但整个请求体（文件 + 其他 form 字段）超了 PHP 的 post_max_size 或 Node.js 的 body-parser 限制。Laravel 里常表现为能收到文件，但 request()->get('code') 为空；Nginx 日志无记录，后端日志也收不到该请求——本质是 Web 服务器在解析 multipart 前就因总 payload 超限丢弃了请求。
- 查
post_max_size（PHP）、maxBodyLength（Axios）、limit（Express）等参数，它们控制的是整个请求体，不只是文件 - 确保
post_max_size≥upload_max_filesize+ 所有其他字段预估体积（比如 base64 图片、长文本） - Layui 的
data选项传的字段也会计入总大小，别忽略
真正难调试的点在于：它不报 413，也不进后端代码，连日志都静悄悄——得靠 Network 面板看响应状态码、响应头是否为空，再结合 Nginx error log 确认是否被 early drop。
