layui.upload 默认不支持 timeout 参数，需设 iframe: false 启用 XHR 模式，并在 before 回调中手动创建 XMLHttpRequest 设置 timeout 和 ontimeout。
layui.upload 默认不响应 timeout 参数
直接在 upload.render() 里写 timeout: 10000 是无效的——这个参数 layui upload 根本不识别。它底层用的是 iframe 或 xhr，但 neither 模式都未暴露 timeout 配置入口。你看到的“接口未响应”提示，大概率是请求卡死、没返回任何东西，而不是被主动中断。
强制启用 XHR 模式并手动设超时
只有把上传切到 XHR 模式，才能真正控制超时逻辑。iframe 模式下超时由浏览器决定，JS 无法干预，也拿不到 ontimeout 回调。
- 必须显式设置
iframe: false，否则所有 timeout 尝试都是徒劳 - 配合
before回调 + 原生XMLHttpRequest手动发请求，才能设xhr.timeout - 别用
$.ajax封装，layui 2.8+ 的模块化环境里它可能不走你设的全局 timeout
示例：
upload.render({
elem: '#upload-btn',
url: '/api/upload',
iframe: false,
before: function(obj) {
const xhr = new XMLHttpRequest();
xhr.timeout = 15000;
xhr.ontimeout = function() {
layer.msg('上传超时，请重试');
obj.error(); // 触发 error 回调
};
xhr.onload = function() {
if (xhr.status >= 200 && xhr.status < 300) {
try {
const res = JSON.parse(xhr.responseText);
if (res.code === 0) {
obj.success(res); // 注意：不是 done()
} else {
obj.error(res.msg || '上传失败');
}
} catch(e) {
obj.error('响应格式错误');
}
} else {
obj.error('HTTP ' + xhr.status);
}
};
xhr.onerror = function() {
obj.error('网络错误');
};
const formData = new FormData();
formData.append('file', obj.files[0]);
xhr.open('POST', '/api/upload', true);
xhr.send(formData);
return false; // 阻止默认上传
}
});
“接口未响应”不等于超时，先确认是否真发出了请求
很多所谓“超时”其实是请求根本没发出去。打开 DevTools → Network → 点上传，看那个请求是否存在、状态是否为 pending 或 blocked:mixed-content。
- HTTPS 页面里写了
http://地址 → 浏览器静默拦截，连 error 回调都不触发 - 后端没返回任何响应头（比如 PHP 缓冲未 flush、Node.js 忘了
res.writeHead()）→ iframe 无限等待 - 反向代理（如 Nginx）限制了 body size 或超时时间，比前端更早中断请求
用 curl -v 直接测接口，看真实耗时和响应头，别只信浏览器表现。
超时值设多少才算合理
60 秒是常见默认值，但对上传场景太粗放。视频或大附件上传本身就要时间，设太短反而频繁报错；设太长又让用户干等。
- 普通图片（8000–12000 毫秒较稳
- 视频（50–500MB）：按带宽估算，Wi-Fi 下建议
30000，4G 下至少60000 - 千万别设
0或过长（如 300000），会阻塞用户操作，且无法取消
真正难的不是设数字，而是超时后怎么给用户明确反馈、要不要自动重试、失败文件是否还保留在选择列表里——这些 layui 都不管，得你自己在 error 回调里补全。
