HAR 文件详解:内容、用途与使用方式

引言

调试网页接口、排查加载慢的问题时,你可能经常听到”导一份 HAR 发我”这样的话。HAR 就像浏览器为一次访问留下的完整”就诊病历”,把每个网络请求从发起、连接、传输到响应的全部细节都记录了下来。

这篇文章讲清三件事:HAR 文件到底记录了什么内容、能拿来做什么、以及具体怎么用。适合前端、后端和测试同学阅读。

HAR 文件是什么

HAR(HTTP Archive)是一种以 JSON 格式保存的归档文件,扩展名是 .har,标准由 HTTP Archive 工作组维护(当前广泛使用的版本为 1.2)。

它本质上是浏览器与服务器之间所有 HTTP 交互的结构化记录。你可以直接用文本编辑器打开它,看到的就是层层嵌套的 JSON。

(生活比喻:把 HAR 想成一张”全程记录的快递单”——每个 HTTP 请求像一次寄件,HAR 记下了寄件时间、寄了什么、每个转运环节耗时多久、最终投递结果如何。区别在于:快递单记的是包裹,HAR 记的是网络请求,而且精确到毫秒。)

HAR 文件的内容

HAR 的根对象是 log,它包含文件版本、创建工具、浏览器信息、页面列表,以及最核心的 entries(请求/响应条目数组)。结构如下:

logversion(版本)creator(工具)browser(浏览器)pages(页面)entries[]核心:请求/响应条目requestresponsecachetimingsmethod / urlheaders / cookiesqueryString / postDatastatus / statusTextheaders / contentredirectURL缓存命中信息与缓存策略dns / connect / sslsend / waitreceive(各阶段耗时)

图 1:HAR 文件的 log 对象结构

其中 entries 里的每条记录,是分析的核心:

  • request:请求方法(GET/POST 等)、URL、HTTP 版本、请求头、Cookie、查询参数、请求体(表单或 JSON)
  • response:状态码、状态文本、响应头、响应内容(正文、大小、MIME 类型)、重定向地址
  • cache:命中缓存的命中与策略信息
  • timings:各阶段耗时(毫秒)——DNS 解析、TCP 连接、TLS 握手、发送、等待(服务器处理)、接收
  • startedDateTime / time:请求发起时间与总耗时

简单说:HAR 把”谁在什么时间、向哪个地址、发了什么、服务器回什么、每步花了多久”全部记了下来。

HAR 的用途

  1. 性能分析:通过 timings 各阶段耗时,定位慢在 DNS 解析、服务器处理还是传输阶段
  2. 网络调试 / 排障:查看状态码、报错、重定向链,排查接口 4xx/5xx、跨域等问题
  3. 问题复现:把 HAR 发给后端或同事,对方按记录到的请求参数即可还原现场、复现缺陷
  4. 接口分析与联调:从 HAR 提取接口的请求/响应结构,生成接口文档或核对字段
  5. 前端优化:分析资源加载顺序、合并请求、检查缓存命中,找到拖慢首屏的瓶颈

使用方式

方式一:浏览器导出

  1. 按 F12 打开开发者工具,切到 Network(网络) 面板
  2. 勾选 Preserve log(保留日志),然后完整操作一遍要记录的功能
  3. 点击顶部 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
2
3
4
5
6
7
8
9
10
11
12
13
import json

# 读取导出的 HAR 文件
with open("export.har", encoding="utf-8") as f:
har = json.load(f)

entries = har["log"]["entries"]
# 按总耗时从高到低排序,取前 5
slowest = sorted(entries, key=lambda e: e["time"], reverse=True)[:5]

for e in slowest:
req = e["request"]
print(req["method"], req["url"], f"{e['time']:.0f}ms")

常见问题与注意事项

  • HAR 包含敏感信息:里面可能有 Cookie、Authorization、Token,分享前要确认对方可信,不要随意贴到公开渠道
  • 文件可能很大:大型页面导出的 HAR 可能几十 MB,分析时注意性能,分享前可考虑裁剪无关条目
  • 导出前先完整复现:只导出了一半操作,缺失的请求自然不在文件里,务必在勾选 Preserve log 后跑完整流程再导出

总结

  • HAR 是 JSON 格式的 HTTP 交互归档(标准 1.2),核心是 log.entries 里的请求/响应条目
  • 它记录了请求细节、响应结果和 timings 各阶段耗时,用于性能分析、排障、问题复现和接口分析
  • 浏览器 F12 → Network → Export 即可导出;也能用分析工具或 json / haralyzer 脚本解析
  • 分享 HAR 前注意剥离或确认敏感信息,避免泄露 Cookie 与 Token