常见原因包括：①用location.href或window.open()跳转导致静默失败；②GET请求URL超限引发400错误；③后端流未完整写入或响应提前关闭；④按钮未防重复点击致多次请求；⑤Content-Disposition中文文件名未按RFC 5987编码。
点击按钮后浏览器没反应，服务器也没收到请求
常见原因是前端用 location.href 或 window.open() 直接跳转到后端接口，但大文件下载接口若返回非 200 状态（如 401、500）、或响应头缺失 Content-Disposition，浏览器会静默失败，不弹出保存框也不报错。更关键的是：GET 请求有 URL 长度限制，带参数的打包请求（如指定多个文件 ID）极易超限，导致请求被截断或 400 错误。
正确做法是用 fetch + Response.blob() 手动触发下载：
- 用 POST 发送 JSON 参数（避免 URL 截断），后端接收后生成临时 ZIP 并返回二进制流
- 前端拿到
blob后创建URL.createObjectURL()，再用document.createElement('a')模拟点击 - 务必设置
response.headers.get('Content-Disposition')中的文件名，否则 Chrome 下载默认叫 “download”
后端返回 ZIP 流但浏览器只下载几百字节
这是典型的流未完整写入或响应提前关闭。Node.js 的 express 常见错误是直接 res.send(zipBuffer) —— 对大文件会内存爆掉；Python Flask 若用 return send_file(...) 但没设 as_attachment=True，部分浏览器可能尝试渲染而非下载。
实操建议：
- Node.js：用
archiver管道直写res，配合res.setHeader('Content-Type', 'application/zip')和res.setHeader('Content-Disposition', 'attachment; filename="files.zip"') - Python：用
send_file(path, as_attachment=True, download_name="files.zip")（注意 Flask 2.2+ 用download_name，旧版用attachment_filename） - 必须禁用压缩：Nginx 需加
gzip off;在 location 块中，否则 ZIP 被 gzip 二次压缩会损坏
用户点一次按钮，后端却收到多次请求
本质是按钮没防重复点击，而大文件打包耗时长（几秒到几十秒），用户习惯性连点。更隐蔽的问题是：某些前端框架（如 Vue）在 v-on:click 里调用异步函数，若没加 .once 或状态锁，fetch 可能并发发起多次请求，后端同时处理多个 ZIP 打包，CPU 和磁盘 I/O 直接拉满。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
简单可靠的防重方案：
- 按钮加
disabled属性： - fetch 前置判断：
if (isDownloading) return;，fetch 成功或失败后都重置isDownloading = false - 后端加轻量级幂等键：前端生成 UUID 放入请求 body，后端缓存该键 5 分钟，重复键直接返回 409 或已有 ZIP URL
打包文件名含中文，Chrome 下载变成乱码
根本原因是 Content-Disposition 头里的 filename 参数不支持 UTF-8 直接编码。RFC 5987 规定必须用 filename*=UTF-8''xxx 格式，但不是所有后端库默认启用。
各语言处理方式：
- Node.js
express：手动拼接，res.setHeader('Content-Disposition', `attachment; filename="files.zip"; filename*=UTF-8''${encodeURIComponent('订单报表_2024.zip')}`) - Python Flask：用
werkzeug.utils.secure_filename()处理原始名，再通过send_file(..., download_name=...)，Flask 会自动按 RFC 编码 - Java Spring Boot：
ContentDisposition.inline().filename("测试.zip").build()内部已处理，无需额外操作
别依赖前端 encodeURI —— 它对空格、括号等字符编码规则和 HTTP 头要求不一致，容易出错。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
