error回调是处理404/500的唯一入口，因Layui仅在HTTP状态码为200且响应体可JSON解析时触发done；否则均进入error，且不暴露xhr实例，需手动接管XHR或查Network面板定位真实错误。
layui upload 的 error 回调才是处理 404/500 的唯一入口
它不区分 http 状态码——只要 xhr 响应状态不是 200，或者响应体无法被 json.parse() 成功解析，error 回调就会触发。而 done 只在「状态码为 200 且响应体是合法 json」时才执行。
常见现象包括：error 被调用但控制台无报错、Network 面板里看到明确的 404/500 状态码、弹窗提示“请求上传接口出现异常”。
- 别在
done里写错误处理逻辑——它根本收不到 404/500 - 后端返回 500 但 body 是 HTML 错误页（如 PHP Fatal Error 页面），Layui 会因 Content-Type 不是
application/json或 JSON 解析失败而进error，而非展示后端错误信息 - 如果后端返回了 404 但 body 是
{"code":0,"msg":"ok"}，Layui 仍会进error，因为 HTTP 状态码已非 200
如何在 error 回调里拿到真实状态码和响应内容
Layui 的 error 回调参数只有 index（上传实例索引）和 upload（上传对象），**不直接暴露 xhr 实例**。想获取状态码或原始响应，必须手动接管 XHR：
- 用
auto: false关闭自动上传 - 在
before回调里构造原生XMLHttpRequest或用fetch，自行处理状态码和响应体 - 上传成功后手动调用
upload.success(index, res)；失败则调用upload.error(index, msg) - 注意：
upload.success()和upload.error()是内部方法，Layui 文档未公开，但源码中稳定存在（2.8+ 版本可用）
示例片段（简化版）：
upload.render({
elem: '#test',
auto: false,
url: '/api/upload',
before: function(obj){
var file = this.file;
var xhr = new XMLHttpRequest();
xhr.open('POST', '/api/upload');
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.onload = function(){
if(xhr.status === 200){
try {
var res = JSON.parse(xhr.responseText);
upload.success(obj.index, res); // 触发 done
} catch(e) {
upload.error(obj.index, '响应不是合法 JSON');
}
} else {
upload.error(obj.index, 'HTTP ' + xhr.status + ': ' + xhr.statusText);
}
};
xhr.onerror = function(){ upload.error(obj.index, '网络错误'); };
xhr.send(new FormData());
}
});
后端返回 404 却说“文件已上传成功”的坑
这是 Nginx 层面的典型静默失败：当上传大文件时，Nginx 尝试把请求体写入 client_body_temp 目录失败（比如权限不足、磁盘满、路径不存在），它不会返回 500，而是直接中断连接并返回 404 —— 此时后端代码甚至没被执行，文件当然也没存。
- 检查 Nginx 错误日志，搜索
client_body_temp和Permission denied - 确认
client_body_temp_path目录存在且 Nginx worker 进程用户（如www-data或nginx）有读写权限 - 不要只看 PHP 或 Java 日志——这种错误根本到不了应用层
- 小文件能传、大文件 404，基本可锁定是这个原因
为什么加了 dataFilter 也救不了 404/500
dataFilter 只在 done 执行前对响应体做转换，它**完全不参与状态码判断或网络错误捕获**。也就是说，只要 XHR 没拿到 200 响应，dataFilter 根本不会运行。
-
dataFilter是数据清洗工具，不是错误兜底机制 - 如果你发现
dataFilter里的代码没执行，先去 Network 看状态码，而不是怀疑 filter 写错了 - 想统一处理所有失败场景，必须依赖
error回调或手动接管 XHR
真正容易被忽略的是：Layui 把「网络层失败」「协议层失败（非200）」「解析层失败（JSON异常）」全塞进同一个 error 回调，却不告诉你具体是哪一层崩了——得靠 Network 面板逐个排除。
