Layui上传文件报错“请求上传接口出现异常”排查-Layui教程-PHP中文网

Layui.upload报“请求上传接口出现异常”根本原因是服务端响应格式不符：必须返回纯文本"0"或JSON中严格含code:0且无多余顶层字段；Content-Type须为application/json；跨域、非200状态码、空响应等也触发该提示。

为什么 `layui.upload` 总报“请求上传接口出现异常”

这个错误不是前端代码本身崩溃，而是 layui.upload 在收到服务端响应后，主动判定“上传失败”并抛出的提示。根本原因几乎都出在服务端返回的数据格式不符合 layui 的硬性要求——它只认两种成功响应：纯文本 "0"，或 json 中必须含 code: 0 字段且不能有其他顶层字段干扰。

`dataFilter` 被忽略？检查你是否误用了 `done` 回调

Layui 的上传组件不走标准 Promise 或 success 钩子，它靠 done 回调处理服务端返回。但很多人把逻辑写在 done 里，却没注意：如果服务端返回的是 {"code":0,"msg":"ok","data":{"src":"xxx"}}，Layui 默认只取最外层的 code 和 msg，data 会被直接丢弃——除非你手动用 dataFilter 做转换。

不加 dataFilter 时，Layui 要求响应体是 {"code":0,"msg":"success"} 或 {"code":0}，多一个字段（比如 data）就可能被判定为解析失败
加了 dataFilter 后，你得自己 return 一个符合 Layui 期望的对象：return {code: res.code, msg: res.msg || '上传成功'}
常见翻车点：在 dataFilter 里忘了 return，或 return 了 res.data（错！那是文件信息，不是上传结果对象）

后端返回 Content-Type 不是 `application/json` 也会触发该错误

Layui 内部用 JSON.parse 尝试解析响应体，前提是它认为这是 JSON。如果后端返回 text/plain 或 text/html（比如 PHP 没设 header、Node.js 忘了 res.json()），哪怕内容是 {"code":0}，Layui 也会因类型不匹配而静默失败，最终显示“请求上传接口出现异常”。

PHP 示例：必须加 header('Content-Type: application/json; charset=utf-8');
Node.js（Express）示例：用 res.json({code: 0})，别用 res.send(JSON.stringify({...}))
Java（Spring Boot）：确保 Controller 方法返回 @ResponseBody + 对象，或显式设置 produces = "application/json"