Skip to content

fix(okhttp): Don't block on response bodies by reading the body upfront - #6231

Open
markushi wants to merge 26 commits into
mainfrom
fix/okhttp-unknown-length-response-body
Open

markushi wants to merge 26 commits into
mainfrom
fix/okhttp-unknown-length-response-body

Conversation

@markushi

@markushi markushi commented Oct 7, 2026 •

Copy link
Copy Markdown
Member

📜 Description

SentryOkHttpInterceptor captured the response body with peekBody(MAX_NETWORK_BODY_SIZE + 1). A peek
is request(n), which waits for n bytes or for the end of the stream — a body with no
Content-Length delivers neither, so the interceptor never returned and the application never
received the response.

Every response body now goes through the new CapturedResponseBody, which copies the bytes the
application reads into a capped buffer. Nothing is read for the capture itself. The status code and
the headers are recorded before anything is consumed, so a stream that stays open still produces a
usable breadcrumb.

💡 Motivation and Context

With Session Replay network details enabled for a URL, every Server-Sent Events, long-poll or open
chunked endpoint hung forever or failed with a SocketTimeoutException. Gzipped responses were
affected too: OkHttp strips Content-Length when it decompresses, so an application interceptor sees
-1.

Continues carlonzo#1 by @carlonzo

Fixes #6138

💚 How did you test it?

Added unit tests, including a regression test that hangs without the fix.

📝 Checklist

  • I added GH Issue ID & Linear ID
  • I added tests to verify the changes.
  • No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
  • I updated the docs if needed.
  • I updated the wizard if needed.
  • Review from the native team if needed.
  • No breaking change or entry added to the changelog.
  • No breaking change for hybrid SDKs or communicated to hybrid SDKs.
  • Public API changes reviewed by another Mobile SDK team member or implemented according to the develop docs spec.

🔮 Next steps

carlonzo and others added 14 commits October 6, 2026 13:32
Capturing a response body for session replay peeked it up front with
`Response.peekBody(MAX_NETWORK_BODY_SIZE + 1)`. OkHttp implements a peek as
`request(byteCount)`, which keeps reading until that many bytes are buffered or
the stream ends. A response with no Content-Length never satisfies either
condition, so for server-sent events, long-poll and any chunked endpoint that
stays open the interceptor never returned and the caller never received the
response at all.

Bodies with a known length still end on their own, so they keep the existing
up-front capture. Bodies of unknown length are now wrapped in a body that
copies what the application consumes into a capped buffer and reports it once
no more bytes can arrive: when the stream ends, when the application closes
the body, or when the cap is reached.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Split the capture wrapping into its own function to keep a single return, and
suppress TooManyFunctions on the interceptor as done elsewhere in this module.
A response body has a single consumer, and neither Http1ExchangeCodec.cancel()
nor Http2ExchangeCodec.cancel() closes the body, so nothing reaches this class
from another thread. The AtomicBoolean already guarantees the capture is
reported exactly once.
A streamed body is only known once it has been consumed, which can be after the
NetworkRequestData carrying it was handed to the scope, so the replay thread can
read it while it is still being written. Keeping the three response values
behind one volatile reference means a reader sees either nothing or the
complete set.
@sentry

sentry Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

📲 Install Builds

Android

🔗 App Name App ID Version Configuration
SDK Size io.sentry.tests.size 8.61.1 (1) release

⚙️ sentry-android Build Distribution Settings

@markushi
markushi marked this pull request as ready for review October 22, 2026 07:43
@markushi markushi changed the title fix(okhttp): Don't block on response bodies with no known length fix(okhttp): Don't block on response bodies by reading the body upfront Oct 22, 2026
@markushi markushi added the sanity-check PR needs a lightweight review for obvious issues label Oct 22, 2026

@0xadam-brown 0xadam-brown left a comment •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks a bunch for this 💯 ! A few comments from my end below.

Also, out of scope for now, but it looks like there might be a request-side version of this bug, in that the request body is still read into memory before the request is sent (link). Presumably that means streaming, duplex, or large uploads to an allowlisted URL can hang / lose data / trigger an OOM.

Let me know if you want me to open an issue 👍

* @param delegate the body to capture from.
* @param maxBytes the maximum number of bytes to retain; capture stops once it is reached.
* @param onCaptured invoked at most once, synchronously, on the thread that finishes the body — so
* it must not block. A body that is abandoned without being read to the end or closed never

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

l: Double-checking that the onCaptured KDoc is correct? I see, eg, that we invoke the callback from CapturedResponseBody.read() if we hit maxBytes or encounter an IOException.

Comment thread sentry-okhttp/src/main/java/io/sentry/okhttp/CapturedResponseBody.kt Outdated
Comment thread sentry-okhttp/src/main/java/io/sentry/okhttp/CapturedResponseBody.kt Outdated
Comment thread sentry-okhttp/src/main/java/io/sentry/okhttp/SentryOkHttpInterceptor.kt Outdated
Comment thread sentry-okhttp/src/test/java/io/sentry/okhttp/CapturedResponseBodyTest.kt Outdated

public static <T> @NotNull ReplayNetworkRequestOrResponse createResponse(
@NotNull final T httpObject,
@Nullable final Integer statusCode,

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be worth calling the binary incompatible changes out in the CHANGELOG since they show up in sentry rather than sentry-okhttp??

That said, happy to defer to you, esp if we always assume breaking changes to ApiStatus.Internal types are allowed.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, it's usually not required for anything marked ApiStatus.Internal, I'll double check that the hybrid SDK are not using it.

Comment thread CHANGELOG.md Outdated

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 4dbcbfa. Configure here.

Comment thread sentry-okhttp/src/main/java/io/sentry/okhttp/CapturedResponseBody.kt Outdated
@getsentry getsentry deleted a comment from sentry-junior Bot Oct 23, 2026
@getsentry getsentry deleted a comment from sentry-junior Bot Oct 23, 2026
…getsentry/sentry-java into fix/okhttp-unknown-length-response-body

@0xadam-brown 0xadam-brown left a comment •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the updates - looking great!

A few possibilities I noticed on a second pass. Otherwise nice all around 👍


val breadcrumbData = mutableMapOf<String, Any?>()

val networkDetailData = httpNetworkDetails.remove(breadcrumb)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

m: If a segment is built before the body is read, could the body from the second setResponseDetails() call get lost here? (It looks like the entry is removed when the replay converter first processes the breadcrumb.)

Could also be smart to include a test that converts the breadcrumb before the body is consumed.

override fun close() {
// Closing the delegate notifies listeners, which may serialize the breadcrumb this capture
// belongs to, so report first.
delegate.use { reportCaptured() }

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

m: Should close() also close capturingSource if it was created? Without it, seems the app could keep reading buffered bytes.


private fun reportCaptured() {
if (reported.compareAndSet(false, true)) {
onCaptured(synchronized(captured) { captured.clone().readByteArray() })

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

m: Thoughts about draining instead of clone here + skip copying once reported? Otherwise a long SSE stream might keep the buffer alive and acquire the lock on every read.

// This runs on the thread consuming the body, inside its read or close, so a failure in
// here must stay in here.
try {
recordResponse(networkDetailData, knownBodySize ?: capturedBytes.size.toLong()) {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

l: When a body is closed early or a read fails, is the prefix treated as a complete body? Wondering whether a cut-off JSON body would show up as INVALID_JSON rather than truncated, and whether the size would be off...

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

sanity-check PR needs a lightweight review for obvious issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Gate OkHttp body capture on active Session Replay

3 participants