Layui.upload拒绝非标准JSON响应，因其硬编码只识别数字型code和字符串型msg字段，且要求Content-Type为application/json；BOM、空格、HTML注释或非JSON响应头均导致解析失败并静默进error回调。
layui.upload 为什么拒绝非标准 JSON 响应
Layui upload 不做字段映射、不支持自定义 status 字段名，它只认硬编码的 code（必须是数字）和 msg（必须是字符串）——哪怕后端返回 {"status": 0, "message": "ok"}，也会进 error 回调并报 data-format-error。
更隐蔽的问题是：响应体开头有 BOM、末尾多一个 ;、中间混了 HTML 注释、或用 var_dump() 调试输出残留，都会导致 JSON.parse() 失败，直接跳过 done，连日志都不打。
常见现象包括：done 不触发、控制台静默、弹出“请求上传接口出现异常”、或始终走 error 回调。
response 配置项根本不管 JSON 解析失败
response 里的 statusName、msgName 等字段，只在 JSON 解析成功后才起作用；一旦原始响应不是合法 JSON 字符串，Layui 根本不会走到这一步——所以改 response 对解析失败毫无意义。
实操建议：
- 别依赖
response去“适配”错误格式，它不是解析器，只是字段提取器 - 所有清洗、容错、重解析逻辑，必须写在
done或error回调里 - 最可靠的原始数据源是
xhr.responseText，不是res参数
在 done 回调里手动解析并清洗响应
绕过 Layui 的解析限制，直接拿原始响应字符串，自己做清洗和 JSON.parse()。这是目前唯一能稳定处理非标准响应的方式。
示例代码：
layui.upload.render({
elem: '#upload',
url: '/api/upload',
done: function(res, index, upload, xhr) {
// 拿原始响应体，而非被 layui 处理过的 res
let raw = xhr.responseText?.trim();
if (!raw) {
console.error('空响应', { xhr });
return;
}
// 清洗 BOM、控制字符、多余空格
raw = raw.replace(/^\uFEFF/, '').replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '').trim();
try {
let data = JSON.parse(raw);
// 此时 data 是你后端真实返回的对象，可自由取值
console.log('上传成功，路径：', data.url || data.data?.url);
// 后续业务逻辑...
} catch (e) {
console.error('JSON 解析失败', { raw, error: e.message });
// 可提示用户、上报错误、或 fallback 到默认行为
}
}
});
关键点：
- 必须用
xhr.responseText，res在解析失败时是空或不可靠的 -
replace(/^\uFEFF/, '')清掉 UTF-8 BOM，PHP/Windows 编辑器易产生 - 别信浏览器 Network 面板的“Preview”，看 “Response” 栏原文本才准
真正容易被忽略的是服务端响应头
即使 JSON 内容完全正确，如果响应头没设 Content-Type: application/json，Layui 就不会尝试解析，直接进 error 回调——这时候 xhr.responseText 能拿到内容，但 res 是空的。
排查方法：
- 打开 Chrome Network 面板，找到上传请求，点开 → Headers → Response Headers
- 确认存在
Content-Type: application/json，不能是text/plain或text/html - Node.js 用
res.json()、Spring Boot 加@RestController+produces = "application/json"、PHP 手动header('Content-Type: application/json')
跨域场景下，Nginx 或 CDN 还可能缓存了 50x 错误页（HTML 格式），把它当响应返回给前端——这种“假响应”最难排查，务必检查缓存策略。
