Next.js middleware ఎందుకు ఉపయోగించబడుతుంది?

Question

Accepted Answer

**Middleware** అనేది **ఒక అభ్యర్థన పూర్తి కానికి ముందు** — Edge పై, పేజీ లేదా route handler ప్రతిబింబించే ముందు — నడిచే కోడ్. ఇది అభ్యర్థనలను తనిఖీ చేయడానికి మరియు తిరిగి వ్రాయడానికి/రీడైరెక్ట్ చేయడానికి, హెడర్‌లను సెట్ చేయడానికి, లేదా ఒక స్థానంలో అనేక మార్గాల కోసం ప్రామాణికతను తనిఖీ చేయడానికి అనుమతిస్తుంది.

## Middleware నిర్వచనం

```ts
// middleware.ts (at the project root)
import { NextRequest, NextResponse } from "next/server";

export function middleware(req: NextRequest) {
  const token = req.cookies.get("session")?.value;

// protect /dashboard — redirect unauthenticated users to login
  if (req.nextUrl.pathname.startsWith("/dashboard") && !token) {
    return NextResponse.redirect(new URL("/login", req.url));
  }
  return NextResponse.next(); // allow the request to proceed
}

// only run on these paths (performance — don't run on every asset)
export const config = { matcher: ["/dashboard/:path*", "/account/:path*"] };
```

## Middleware ఏమి చేయగలదు

```ts
NextResponse.redirect(url);          // send the user elsewhere (auth gates)
NextResponse.rewrite(url);           // serve different content, URL unchanged (A/B, i18n)
NextResponse.next();                  // continue, optionally with modified headers
// req.geo / req.cookies / req.headers — inspect location, auth, etc.
```

సాధారణ ఉపయోగాలు: **ప్రామాణీకరణ గేటింగ్**, **రీడైరెక్ట్‌లు** (లోకేల్/జియో-ఆధారిత, www→apex), **A/B టెస్టింగ్** తిరిగి వ్రాయడ ద్వారా, **సुरक్ష హెడర్‌లు** సెట్ చేయడం మరియు bot/feature ఫ్లాగ్‌లు.

## ముఖ్య పరిమితులు

```text
⚠️ Runs on the EDGE runtime → no Node.js APIs (no fs, limited libraries)
⚠️ Must be FAST — it runs before every matched request; heavy work adds latency
⚠️ Can't access the database directly for complex auth — do lightweight checks
   (e.g. verify a JWT/cookie exists); do full auth in the page/handler
```

`matcher` ఆకృతి ముఖ్యమైనది: మిడిలవేర్‌ను కేవలం కావలసిన మార్గాలకు పరిమితం చేయండి, తద్వారా ఇది స్థిర ఆస్తులపై నడవకుండా మరియు ప్రతిదీ నెమ్మదిస్తుంది.

## ఇది ఎందుకు ముఖ్యమైనది

Mmiddleware అనేది క్రాస్-కట్టింగ్ అభ్యర్థన తర్కం కోసం ఒకే చోక్ పాయింట్ — ప్రామాణీకరణ రీడైరెక్ట్‌లు, లోకేల్ రూటింగ్, తిరిగి వ్రాయడం మరియు హెడర్‌లు — ప్రతి పేజీలో కోడ్‌ను పునరావృతం చేయకుండా అనేక మార్గాలకు వర్తించబడతాయి.

తన Edge సరిహద్దుల (వేగవంతమైన, Node APIs లేవు, తేలికపాటి చెక్‌లు మాత్రమే) మరియు `matcher` స్కోపింగ్ గురించి తెలుసుకోవడం దీనిని గేటీకీపింగ్ మరియు రూటింగ్ ఆందోళనల కోసం సరిగ్గా ఉపయోగించడానికి అనుమతిస్తుంది.