Validating Files

It can be quite challenging to ensure that source maps are actually valid themselves and uploaded correctly. To help with this, we maintain an online validation tool that can be used to test your source maps against your hosted source: sourcemaps.io.

Additionally, you can use the --validate flag within when uploading source maps with sentry-cli, which will attempt to locally parse the source map and look up the references. Note that there are known cases where the validate flag will indicate failures when the setup is correct (if you have references to external source maps, then the validation tool will indicate a failure).

You can also check these, in addition to the validation step:

  • Ensure that the URL prefix is correct for your files. This is easy to get wrong.
  • Upload the matching source maps for your minimized files.
  • Ensure that the minified files you have on your servers actually have references to your .map files.
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) to suggesting an update ("yeah, this would be better").