请求响应关联与线程约束

同一个 URL 可以连续或并发请求多次。get_requests 给出的每个 requestId 必须对应那次请求的状态和正文，get_response_body 与 wait_for_response 也必须沿用这个 ID。只比 URL 或选择最近一条未完成请求，无法证明响应归属。

精确关联与有序采集

服务按请求对象关联响应，为同一 URL 的连续请求和并发请求分别保留 requestId。get_requests、get_response_body 与 wait_for_response 使用统一的登记逻辑，方便从请求记录追踪到响应状态和正文。

正文在下载完成事件中，由当前 Playwright 调用线程读取并缓存。采集与页面操作遵循相同的线程模型，便于保持浏览器事件顺序，并在后续命令中直接读取已保存的正文。

Playwright Java 的线程说明要求同一 Playwright 实例及其派生对象在同一线程调用，或者保证任一时刻只有一个线程调用。服务按这一调用约定组织网络记录与正文采集。

时机	操作
request	生成 requestId，保存请求元数据，登记请求对象，在途计数加一
response	按请求对象找到原记录，回填 status 和 respondedAt，在途计数减一，登记响应
requestfinished	下载完成，在当前 Playwright 调用线程读取并缓存 xhr/fetch 正文
requestfailed	若请求仍在待响应索引中，记录 failure 和 finishedAt，并释放在途计数

这里的在途计数表示尚未收到响应头或失败事件的请求数，不表示正文下载完成数。不要用它判断缓存是否已经写好。

正文缓存由下载完成事件触发，读取正文为同步调用，计入当前命令的执行时间。缓存只覆盖 xhr/fetch；流式响应在下载结束前不会进入完成缓存，提前读取完整正文仍可能等待。

同一响应重复进入记录逻辑时复用已有记录。wait_for_response 的等待分支也走同一个登记方法，沿用关联请求的 ID。

字段	含义
requestId	本次请求的标识，读取正文时原样传回
correlationMissed: false、correlatedBy: identity	已找到请求记录，响应沿用原 ID
correlationMissed: true、correlatedBy: none	没找到请求记录；新记录明确标记缺失关联，不冒充相同 URL 的另一次请求
bodyFromCache: true、bodyCapturedAt	正文来自已保存的缓存及其保存时间
bodyCapturePending: true	可缓存类型尚未完成缓存，不等于没有收到响应头
truncated、bodyCachedChars	正文被返回长度限制或缓存上限截断；缓存上限截断时给出上限

只捕获到响应的情况可能发生在认领已有页签之后。新增记录中的 requestedAt 是补记时刻，不能当作真实发起时间。正常关联不生成第二个 requestId；缺失关联也不按 method、URL 或请求体进行猜测，因为这些字段完全相同的请求仍可能并发存在。

请求元数据最多保留 200 条，响应最多保留 100 条，正文每条最多缓存 100000 字符。缓存截断后，bodyLength 表示缓存中保留的字符数，不能据此推算完整响应长度。下载完成前就被容量限制淘汰的响应不会继续占用正文缓存。

在浏览器服务模块目录执行：

mvn -o test -Dtest=BrowserResponseIntegrationTest -DfailIfNoTests=false
mvn -o test -Dtest=ResponseCorrelationTest -DfailIfNoTests=false
mvn -o test

集成测试使用临时浏览器 profile 和本地 HTTP 服务。验证连续两次请求只增加两条记录，并且不同请求体对应各自 requestId；另发出 12 个相同 URL 的并发请求，交错返回，逐条检查状态、正文、缓存和回调线程，导航后再检查缓存仍能读取。

单元测试直接断言正文读取发生在调用线程、重复缓存不重复读取、读取失败被记录，以及关联缺失不会占用另一个相同 URL 请求的 ID。等待响应超时会抛出包含请求总数和未响应数量的断言错误；不提高超时、不重发整个测试动作、不忽略失败用例。

参见网络记录与请求拦截、整合 Playwright 的线程边界和t-io 稳定性设计与资源管理。IO 层管理连接与共享 Worker，浏览器层按 Playwright 的线程约定组织调用，两者共同完成请求处理。