Layui上传组件如何处理后台返回的404或500错误

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 状态码、弹窗提示“请求上传接口出现异常”。

1. 别在 done 里写错误处理逻辑——它根本收不到 404/500
2. 后端返回 500 但 body 是 HTML 错误页（如 PHP Fatal Error 页面），Layui 会因 Content-Type 不是 application/json 或 JSON 解析失败而进 error，而非展示后端错误信息
3. 如果后端返回了 404 但 body 是 {"code":0,"msg":"ok"}，Layui 仍会进 error，因为 HTTP 状态码已非 200

如何在 error 回调里拿到真实状态码和响应内容

Layui 的 error 回调参数只有 index（上传实例索引）和 upload（上传对象），不直接暴露 xhr 实例。想获取状态码或原始响应，必须手动接管 XHR：

1. 用 auto: false 关闭自动上传
2. 在 before 回调里构造原生 XMLHttpRequest 或用 fetch，自行处理状态码和响应体
3. 上传成功后手动调用 upload.success(index, res)；失败则调用 upload.error(index, msg)
4. 注意：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 —— 此时后端代码甚至没被执行，文件当然也没存。

1. 检查 Nginx 错误日志，搜索 client_body_temp 和 Permission denied
2. 确认 client_body_temp_path 目录存在且 Nginx worker 进程用户（如 www-data 或 nginx）有读写权限
3. 不要只看 PHP 或 Java 日志——这种错误根本到不了应用层
4. 小文件能传、大文件 404，基本可锁定是这个原因

为什么加了 dataFilter 也救不了 404/500

dataFilter 只在 done 执行前对响应体做转换，它完全不参与状态码判断或网络错误捕获。也就是说，只要 XHR 没拿到 200 响应，dataFilter 根本不会运行。

1. dataFilter 是数据清洗工具，不是错误兜底机制
2. 如果你发现 dataFilter 里的代码没执行，先去 Network 看状态码，而不是怀疑 filter 写错了
3. 想统一处理所有失败场景，必须依赖 error 回调或手动接管 XHR

真正容易被忽略的是：Layui 把「网络层失败」「协议层失败（非200）」「解析层失败（JSON异常）」全塞进同一个 error 回调，却不告诉你具体是哪一层崩了——得靠 Network 面板逐个排除。