feat(wrangler): add warning when account_id mismatch detected on auth error

[ascorbic]

Fixes #9358.

When a 401 authentication error occurs, this PR adds a warning if the account_id in the Wrangler configuration does not match any of the user's authenticated accounts. This helps users identify configuration issues where they may have copied an account_id from another account or project.

The warning is displayed after the account list in the whoami output that appears on authentication errors, making it clear that the configured account ID is not accessible with the current credentials.

Key changes:

• Added printAccountIdMismatchWarning function in whoami.ts that checks if the configured account_id matches any authenticated accounts
• Modified handleError to extract account_id from config and pass it to whoami
• Added unit tests for the warning logic

Human review checklist:

• Verify the warning conditions are correct (warning only shows when accountFilter === configAccountId AND account is not in user's accounts)
• Verify the warning message is clear and actionable for users

---

• Tests
  • Tests included
• Wrangler E2E Tests CI Job required?
  • Not required because: This is a warning message enhancement, unit tests cover the functionality
• Public documentation
  • Documentation not necessary because: This is a UX improvement that adds a helpful warning message; no new configuration or API changes
• Wrangler V3 Backport
  • Wrangler PR: fix(wrangler): add warning when account_id mismatch detected on auth error (v3 backport) #11689

Link to Devin run: https://app.devin.ai/sessions/d7fdc064c9914225b7de6694b36e0122
Devin PR requested by @ascorbic

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[changeset-bot]

🦋 Changeset detected

Latest commit: 7c3ed78

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[claude]

Claude finished @ascorbic's task —— View job

---

Changeset Review Complete

• Read changeset guidelines from .changeset/README.md
• Read the changeset file in this PR
• Validate version type
• Validate changelog quality
• Check for forbidden markdown headers
• Provide final assessment

---

✅ All changesets look good

The changeset .changeset/account-id-mismatch-warning.md passes all validation criteria:

• ✅ Correct version type: patch (appropriate for a UX improvement/warning message)
• ✅ No major version (which is forbidden for wrangler)
• ✅ Clear, meaningful description explaining the symptom and how it helps users
• ✅ No forbidden h1/h2/h3 markdown headers
• ✅ Mentions both wrangler.toml and wrangler.jsonc configuration files

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@11683

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@11683

miniflare

npm i https://pkg.pr.new/miniflare@11683

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@11683

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@11683

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@11683

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@11683

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@11683

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@11683

wrangler

npm i https://pkg.pr.new/wrangler@11683

commit: 7c3ed78

[ascorbic]

(aside) I've reviewed this and it looks good.

[github-actions]

Failed to automatically backport this PR's changes to Wrangler v3. Please manually create a PR targeting the v3-maintenance branch with your changes. Thank you for helping us keep Wrangler v3 supported!

Depending on your changes, running git rebase --onto v3-maintenance main devin/1765967113-account-id-mismatch-warning might be a good starting point.

Notes:

• your PR branch should be named v3-backport-11683
• add the skip-v3-pr label to the current PR to stop this workflow from failing