HAR 文件详解:内容、用途与使用方式
HAR 文件详解:内容、用途与使用方式
引言
调试网页接口、排查加载慢的问题时,你可能经常听到”导一份 HAR 发我”这样的话。HAR 就像浏览器为一次访问留下的完整”就诊病历”,把每个网络请求从发起、连接、传输到响应的全部细节都记录了下来。
这篇文章讲清三件事:HAR 文件到底记录了什么内容、能拿来做什么、以及具体怎么用。适合前端、后端和测试同学阅读。
HAR 文件是什么
HAR(HTTP Archive)是一种以 JSON 格式保存的归档文件,扩展名是 .har,标准由 HTTP Archive 工作组维护(当前广泛使用的版本为 1.2)。
它本质上是浏览器与服务器之间所有 HTTP 交互的结构化记录。你可以直接用文本编辑器打开它,看到的就是层层嵌套的 JSON。
(生活比喻:把 HAR 想成一张”全程记录的快递单”——每个 HTTP 请求像一次寄件,HAR 记下了寄件时间、寄了什么、每个转运环节耗时多久、最终投递结果如何。区别在于:快递单记的是包裹,HAR 记的是网络请求,而且精确到毫秒。)
HAR 文件的内容
HAR 的根对象是 log,它包含文件版本、创建工具、浏览器信息、页面列表,以及最核心的 entries(请求/响应条目数组)。结构如下:
图 1:HAR 文件的 log 对象结构
其中 entries 里的每条记录,是分析的核心:
- request:请求方法(GET/POST 等)、URL、HTTP 版本、请求头、Cookie、查询参数、请求体(表单或 JSON)
- response:状态码、状态文本、响应头、响应内容(正文、大小、MIME 类型)、重定向地址
- cache:命中缓存的命中与策略信息
- timings:各阶段耗时(毫秒)——DNS 解析、TCP 连接、TLS 握手、发送、等待(服务器处理)、接收
- startedDateTime / time:请求发起时间与总耗时
简单说:HAR 把”谁在什么时间、向哪个地址、发了什么、服务器回什么、每步花了多久”全部记了下来。
HAR 的用途
- 性能分析:通过
timings各阶段耗时,定位慢在 DNS 解析、服务器处理还是传输阶段 - 网络调试 / 排障:查看状态码、报错、重定向链,排查接口 4xx/5xx、跨域等问题
- 问题复现:把 HAR 发给后端或同事,对方按记录到的请求参数即可还原现场、复现缺陷
- 接口分析与联调:从 HAR 提取接口的请求/响应结构,生成接口文档或核对字段
- 前端优化:分析资源加载顺序、合并请求、检查缓存命中,找到拖慢首屏的瓶颈
使用方式
方式一:浏览器导出
- 按
F12打开开发者工具,切到 Network(网络) 面板 - 勾选 Preserve log(保留日志),然后完整操作一遍要记录的功能
- 点击顶部 Export(导出) 下载按钮,得到
.har文件
(注意:Chrome / Edge 130 起默认导出”已清理 HAR”,会自动剥离 Cookie、Authorization 等敏感信息;如需完整鉴权头,需在设置里打开”允许生成包含敏感数据的 HAR”开关。详细步骤见《处理浏览器录制 HAR 文件丢失敏感信息》一文。)
完整使用流程见下图:
flowchart TD
A["F12 打开 DevTools → Network"] --> B["勾选 Preserve log,操作复现问题"]
B --> C["点 Export 导出 .har 文件"]
C --> D["用工具打开 HAR 分析"]
D --> E["看 timings 定位性能瓶颈"]
D --> F["查状态码 / 请求响应排查报错"]
D --> G["把 HAR 发给后端或同事复现"]
C --> H["或编程解析(json / haralyzer)"]图 2:HAR 的导出与使用流程
方式二:用分析工具打开
导出的 .har 可以直接拖进 Chrome / Firefox 开发者工具的 Network 面板,也可以用专门的分析工具(如 HAR Viewer、Charles、Fiddler、Postman)打开,得到可视化的请求列表与耗时瀑布图。
方式三:编程解析
HAR 是标准 JSON,用脚本即可批量处理。下面这段 Python 找出耗时最长的 5 个请求:
1 | import json |
常见问题与注意事项
- HAR 包含敏感信息:里面可能有 Cookie、Authorization、Token,分享前要确认对方可信,不要随意贴到公开渠道
- 文件可能很大:大型页面导出的 HAR 可能几十 MB,分析时注意性能,分享前可考虑裁剪无关条目
- 导出前先完整复现:只导出了一半操作,缺失的请求自然不在文件里,务必在勾选 Preserve log 后跑完整流程再导出
总结
- HAR 是 JSON 格式的 HTTP 交互归档(标准 1.2),核心是
log.entries里的请求/响应条目 - 它记录了请求细节、响应结果和
timings各阶段耗时,用于性能分析、排障、问题复现和接口分析 - 浏览器 F12 → Network → Export 即可导出;也能用分析工具或
json/haralyzer脚本解析 - 分享 HAR 前注意剥离或确认敏感信息,避免泄露 Cookie 与 Token
