[adinauer]

📜 Description

Adds ignoredErrorsForDeduplication to let exception types bypass throwable-based event deduplication by fully qualified class name or full regular expression.

io.netty.handler.timeout.ReadTimeoutException is excluded by default. Netty reuses ReadTimeoutException.INSTANCE for independent timeout occurrences, so storing that singleton in the SDK-lifetime deduplication map previously caused later timeouts to be discarded indefinitely.

Configuration semantics:

• setIgnoredErrorsForDeduplication replaces the built-in list; null or an empty list removes all exclusions.
• addIgnoredErrorForDeduplication extends the current list and therefore preserves the default entry.
• Exact entries match the fully qualified runtime class name. Regular expressions use full-string matching and do not automatically include subclasses.
• This change exposes programmatic configuration only.

Excluded types are neither checked against nor inserted into the deduplication map. This restores independent occurrences, but also means that multiple integrations capturing the same excluded exception may each send an event. For N occurrences captured through K integrations, volume can reach N × K, which can increase event quota and customer cost during timeout bursts.

💡 Motivation and Context

Netty holds a static reference to ReadTimeoutException.INSTANCE. Because the SDK deduplication processor uses throwable keys in a weak map, the static singleton never becomes collectible and its first capture can suppress unrelated later timeouts for the lifetime of the SDK client.

The configurable exclusion keeps deduplication enabled for other exception types while allowing known reusable exceptions to fail open.

Fixes #6365
Refs JAVA-794

💚 How did you test it?

• ./gradlew :sentry:test --tests io.sentry.DuplicateEventDetectionEventProcessorTest --tests io.sentry.SentryOptionsTest
• ./gradlew spotlessApply apiDump
• git diff --check

📝 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

None.

[linear-code]

JAVA-794

[sentry]

📲 Install Builds

Android

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

⚙️ sentry-android Build Distribution Settings