Skip to main content

[Flutter] Why are my exception types minified (obfuscated)?

Issue

Exceptions captured by the Flutter SDK show obfuscated or minified types in the issue title, such as minified:Lk. This happens because the SDK derives the title from Dart's runtimeType, which is obfuscated when you build with --obfuscate (and always minified on Flutter Web).

Applies To

  • All SaaS Customers and Self-Hosted Users

  • Flutter SDK

  • Debug Symbols

Symptoms

  • Error types and messages are minified, for example:

minified:Lk
TypeError: null: type 'minified:FB' is not a subtype of type 'minified:as'

Resolution

The Flutter SDK builds the issue title from Dart's runtimeType. When you build with --obfuscate, or run on Flutter Web (which is always minified), the type name is not human-readable, so it appears with a minified: prefix. What you can do depends on your platform.

If you build for iOS or Android, upload the Dart obfuscation map so Sentry can deobfuscate the issue titles:

  1. Build with the flags that generate the symbol map:

    flutter build <target> --obfuscate --split-debug-info=<output-directory> --extra-gen-snapshot-options=--save-obfuscation-map=build/app/obfuscation.map.json
  2. In pubspec.yaml, point the Sentry Dart Plugin at that file with dart_symbol_map_path: build/app/obfuscation.map.json. This must point to the file, not a directory.

  3. Run the plugin to upload the symbols. For the full setup, see the Sentry Dart Plugin guide at https://docs.sentry.io/platforms/dart/guides/flutter/debug-symbols/dart-plugin/.

If you run on Flutter Web, deobfuscated issue titles are not supported yet, so titles remain minified. You can still symbolicate stack traces by uploading source maps with the Sentry Dart Plugin, and Sentry is exploring a solution for readable web titles.

If you build for macOS, Linux, or Windows, obfuscation-map upload for issue titles is not supported yet (only iOS and Android are).

Keep the enableExceptionTypeIdentification option set to true (its default). It lets the SDK identify common exception types to improve the readability of obfuscated issue titles. For the full list of known limitations, see the Flutter troubleshooting docs at https://docs.sentry.io/platforms/dart/guides/flutter/troubleshooting/.

Did this answer your question?