fix(core): [Callback Errors 7] Handle replay sampling failures

[adinauer]

PR Stack (Callback Errors)

• fix(core): Handle callback errors #6140
• fix(core): [Callback Errors 1] Report callback failures #6141
• ref(core): [Callback Errors 2] Mark SDK-owned event processors #6162
• fix(core): [Callback Errors 3] Drop failed processor data #6142
• fix(core): [Callback Errors 4] Drop failed breadcrumbs #6143
• fix(core): [Callback Errors 5] Handle tracesSampler failures #6163
• fix(core): [Callback Errors 6] Handle profilesSampler failures #6164
• fix(core): [Callback Errors 7] Handle replay sampling failures #6165

---

📜 Description

Skip replay capture when beforeErrorSampling throws, while continuing to send the error event. Update the error log to reflect that replay capture is skipped.

Callbacks returning true or false, and configurations without a callback, retain their existing behavior. The existing catch type and reentrancy guard are unchanged; subsequent events can still trigger replay capture.

💡 Motivation and Context

A failed user replay filter must not trigger replay capture. Previously, throwing from beforeErrorSampling proceeded with capture, potentially sending replay data the callback intended to exclude.

• refs: Align callback error handling with other SDKs #6081
• Spec discussion: docs(sdk): Specify callback error isolation for user callbacks sentry-docs#19189

💚 How did you test it?

• ./gradlew spotlessApply apiDump
• ./gradlew :sentry:apiCheck :sentry:test --tests='*SentryClientTest*' --tests='*SentryClientInternalEventProcessorTest*' --tests='*SentryReplayOptionsTest*' — 276 tests passed
• Both regression tests failed before the production fix because replay capture was invoked after callback failure.
• Verify handled errors and crashes still reach the transport, replay capture is skipped, the failure is logged, and a subsequent successful callback can capture replay.

📝 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

Profile discard accounting and profile/replay artifact cleanup remain separate follow-ups. Callback-boundary catch-type changes remain deferred to the next major.

⚠️ Merge this PR using a merge commit (not squash). Only the collection branch is squash-merged into main.

[sentry]

📲 Install Builds

Android

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

⚙️ sentry-android Build Distribution Settings