insomnia文件下载失败时，需检查响应头、启用自动保存、手动导出、添加请求头、防缓存脚本及校验文件完整性。
如果您在使用Insomnia测试文件下载接口时，发现响应体为空、无法保存文件或状态码异常，则可能是由于响应头缺失、Content-Disposition未识别或二进制数据未正确解析所致。以下是处理该问题的多种方法：
一、启用响应自动保存并配置文件路径
Insomnia默认不自动保存下载文件，需手动开启并指定目标目录，确保二进制响应被持久化到本地磁盘。
1、点击右上角设置图标（齿轮），选择“Settings”。
2、在左侧菜单中选择“General”，向下滚动至“Response Handling”区域。
3、勾选Automatically save responses when Content-Disposition header is present。
4、点击Change Save Directory，选择一个可写入的本地文件夹（如~/Downloads/insomnia-downloads）。
5、返回请求编辑页，发送下载请求，观察右侧响应面板是否显示“Saved to [path]”提示。
二、手动触发文件保存（无Content-Disposition头时）
当服务端未返回Content-Disposition响应头，但实际返回的是二进制文件（如PDF、ZIP、XLSX），需强制将响应体导出为文件。
1、执行下载请求，确认响应状态码为200且Content-Type为application/octet-stream、application/pdf等二进制类型。
2、在响应面板右上角点击⋯（More Actions）按钮。
3、选择Save Response Body As…。
4、在弹出窗口中输入完整文件名（含扩展名，如report.pdf），并选择保存位置。
5、点击“Save”，验证文件能否正常打开。
三、添加请求头模拟浏览器下载行为
部分后端接口依赖User-Agent或Accept头判断客户端意图，缺失时可能返回HTML错误页而非文件流。
1、在请求编辑区切换到“Headers”标签页。
2、点击“Add Header”，输入键User-Agent，值设为Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36。
3、再添加一项：Accept → */* 或具体类型如 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet。
4、若接口需认证，确保Authorization头已正确配置（如Bearer xxx）。
5、重新发送请求，检查响应是否转为预期二进制流。
四、使用Pre-request Script注入时间戳防止缓存干扰
某些文件下载接口对查询参数敏感，若重复请求被CDN或代理缓存，可能返回旧文件或304响应。通过脚本动态追加唯一参数可规避。
1、切换到请求编辑区的“Scripts”标签页，点击“Pre-request Script”。
2、输入以下JavaScript代码：
const timestamp = Date.now();\ninsomnia.request.url += (insomnia.request.url.includes('?') ? '&' : '?') + 't=' + timestamp;
3、保存脚本，再次发送请求，观察URL是否自动附加?t=1746896450123类参数。
4、对比两次响应的ETag或Last-Modified头，确认未命中缓存。
五、验证响应完整性与文件校验
下载完成后，需确认文件内容未截断或损坏，尤其当响应体较大（>10MB）时，Insomnia可能因内存限制提前终止流式读取。
1、在响应面板底部查看“Size”字段，记录显示的字节数（如2,456,891 B）。
2、前往保存路径，用系统命令行执行校验：
macOS/Linux：ls -l report.xlsx | awk '{print $5}'
Windows PowerShell：(Get-Item .\report.xlsx).Length
3、比对两个数值是否完全一致；若本地文件字节更少，说明响应被截断。
4、此时应检查Insomnia日志（Help → Toggle Developer Tools → Console），查找net::ERR_CONNECTION_ABORTED类错误。
