dart-symbol-map error: unexpected argument '--url' found

[airshu]

CLI Version

3.1.0

Operating System and Architecture

• macOS (arm64)
• macOS (x86_64)
• Linux (i686)
• Linux (x86_64)
• Linux (armv7)
• Linux (aarch64)
• Windows (i686)
• Windows (x86_64)

Operating System Version

macOS 26

Link to reproduction repository

No response

CLI Command

./target/debug/sentry-cli --url https://sentry.xxx.com --auth-token sntrys_eyJpYXxxxxxx dart-symbol-map upload --org sentry --project xxx-app /Users/xxx/xxx/xxx/xxx/output/symbol/mapping.json /Users/xxx/xxx/xxx/xxx/output/symbol/app.android-x64.symbols --log-level debug

Exact Reproduction Steps

Flutter Project Configuration

--obfuscate --split-debug-info=output/symbol --extra-gen-snapshot-options=--save-obfuscation-map=output/symbol/mapping.json

Configuration in pubspec.yaml

sentry:
  org: sentry
  project: xxx-app
  url: https://sentry.xxx.com
  auth_token: xxx
  upload_debug_symbols: true
  upload_sources: true
  upload_source_maps: true
  symbols_path: output/symbol
  dart_symbol_map_path: output/symbol/mapping.json

Error Message

error: unexpected argument '--url' found

Usage: sentry-cli [OPTIONS] <COMMAND>

For more information, try '--help'.

Root Cause Analysis
After analysis, it was found that the error occurs because the url field declaration is missing in the derive_parser.rs file:

pub(super) struct SentryCLI {
    #[arg(global=true, long, value_name="URL")]
    #[arg(help = "Fully qualified URL to the Sentry server.{n}[default: https://sentry.io/]")]
    pub(super) url: Option<String>,
}

Expected Results

Successfully uploaded

Actual Results

Upload failed

Logs

error: unexpected argument '--url' found

Usage: sentry-cli [OPTIONS]

For more information, try '--help'.

[linear]

CLI-272

[szokeasaurusrex]

Hi @airshu, thank you for reporting this bug — I am able to reproduce it.

We will try to ship a fix soon. In the meantime, you can workaround the bug by removing the --url argument. Because you are using an org auth token, indicated by the sntrys_ prefix, the token already encodes the URL. The URL encoded in the token always takes precedence over the manually specified --url, so passing --url is completely unnecessary.