API routes without GET handlers doesn't return a 404 status code

[kcoet]

Which project does this relate to?

Router

Describe the bug

API routes without a GET handler doesn't return a 404 status code by default but return 200 OK, with an error in the console:

{
    "data": {
        "name": "Error",
        "message": "Invariant failed: Expected to find a match below the root match in SPA mode.",
        "stack": "Error: Invariant failed: Expected to find a match below the root match in SPA mode.\n    at invariant (http://localhost:3000/node_modules/.pnpm/tiny-invariant@1.3.3/node_modules/tiny-invariant/dist/esm/tiny-invariant.js?v=c5ed1ad0:12:9)\n    at hydrate (http://localhost:3000/node_modules/.pnpm/@tanstack+router-core@1.132.47/node_modules/@tanstack/router-core/dist/esm/ssr/ssr-client.js?v=c5ed1ad0:141:5)\n    at async hydrateStart (http://localhost:3000/node_modules/.pnpm/@tanstack+start-client-core@1.132.54/node_modules/@tanstack/start-client-core/dist/esm/client/hydrateStart.js?t=1760429159805&v=c5ed1ad0:29:5)"
    },
    "__isServerError": true
}

Route API without a GET handler:

import { createFileRoute } from '@tanstack/react-router';

export const Route = createFileRoute('/api/test-no-get')({
  server: {
    handlers: {
      POST: () => {
        return new Response('ok', { status: 200 });
      },
    },
  },
});

Your Example Website or App

https://stackblitz.com/edit/github-zlbrcubx-vwhcvwvk?file=src%2Froutes%2Fapi%2Ftest-no-get.ts

Steps to Reproduce the Bug or Issue

1. Create an API route without a GET handler.
2. Access the API.
3. Check the console and status code.

Expected behavior

It should return a 404 status code to avoid confusing search engines.

Screenshots or Videos

No response

Platform

• Router / Start Version: 1.132.47 / 1.132.56
• OS: Windows
• Browser: Chrome
• Browser Version: 141.0.7390.77
• Bundler: Vite
• Bundler Version: 7.1.9

Additional context

No response

[luan-coelho]

up

[luan-coelho]

Same problem:

import { createFileRoute } from '@tanstack/react-router'
import { authMiddleware } from '@/middlewares/auth'

export const authMiddleware = createMiddleware().server(async ({ next, request }) => {
  const headers = getRequestHeaders()
  const session = await auth.api.getSession({ headers })
  return next({
    context: {
      session: {
        ...session?.session,
      },
      user: session?.user,
      request,
    },
  })
})

export const Route = createFileRoute('/api/organization/')({
  server: {
    middleware: [authMiddleware],
    handlers: {
      /**
       * Lista organizações com paginação e filtros
       * POST /api/organization/list
       * Body: { pagination?: { page, pageSize }, sort?: { field, direction }, filters?: { search, searchField } }
       */
      POST: async ({ request, context }) => {
        if (!context.user) {
          return Response.json(
            { success: false, message: 'Usuário não autenticado' },
            { status: 401 },
          )
        }
        ...
      },
    },
  },
})

I only receive a blank page: