Redirect with query params works locally but Netlify serves 404 on direct load to /auth/callback

Support
1

Hi all — I’m stuck on a redirect issue that only seems to happen once deployed on Netlify.

I have a small SPA (Vite + React) with client-side routing, and an OAuth callback route at /auth/callback. After login, the provider redirects back with query params like:

https://my-site.netlify.app/auth/callback?code=abc123&state=xyz

Locally, this works fine in dev. In production on Netlify, if I click around from within the app it’s OK, but if I directly load that callback URL or come back from the OAuth provider, I get a 404 page from Netlify before the app can handle the route.

What I expected

I expected Netlify to serve index.html for any SPA route so React Router could handle /auth/callback and read the query string.

What actually happens

Netlify returns a 404 for direct requests to /auth/callback?code=...&state=....

Current setup

netlify.toml:

[build]
  command = "npm run build"
  publish = "dist"

[[redirects]]
  from = "/api/*"
  to = "https://api.example.com/:splat"
  status = 200
  force = true

I also tried adding this:

[[redirects]]
  from = "/*"
  to = "/index.html"
  status = 200

but I’m not sure if I placed it correctly, because the deploy still seems to behave the same way.

I checked the published deploy and index.html is definitely there under dist/.

Things I’ve tried

  • redeploying with cache cleared
  • moving the SPA fallback redirect above and below the /api/* rule
  • testing with and without force = true on the API proxy
  • confirming the OAuth provider is redirecting to the exact production URL

Questions

  1. Is there anything special about callback URLs with query params on Netlify routing?
  2. Does the SPA catch-all need to come after the API redirect, or before it?
  3. Is there a better way to configure this when mixing SPA routes with an /api/* proxy?

If it helps, I can share the full deploy log and site URL, but I wanted to check whether I’m missing something obvious in the redirect config first.

2

Docs: React on Netlify | Netlify Docs

Specifically:

image
image1313×357 24.4 KB

Which links to:

image
image1351×801 59.6 KB

Also, point 2 from this: [Support Guide] I’ve deployed my site but I still see "Page not found”

If you had placed that rule in the same file, it should have worked. However since you’ve not shared your site’s details, it’s not possible for us to check that bit.