[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"blog-it-edge-runtime-vs-node-llm-db-routes":3},{"id":4,"title":5,"author":6,"body":7,"cover":396,"description":397,"draft":398,"extension":399,"locale":400,"meta":401,"navigation":208,"path":402,"publishedAt":403,"seo":404,"seoTitle":405,"slug":406,"stem":407,"tags":408,"__hash__":410},"blog\u002Fit\u002Fblog\u002Fedge-runtime-vs-node-llm-db-routes.md","Edge vs Node per route LLM e database: limiti e split","Manuel Tardivo",{"type":8,"value":9,"toc":384},"minimark",[10,46,81,86,119,123,146,150,153,163,170,174,193,197,233,237,251,257,271,284,288,332,339,343,370,374],[11,12,13,14,18,19,23,24,27,28,31,32,23,35,23,38,41,42,45],"p",{},"“Edge” (Vercel Edge, Cloudflare Workers, alcune route Nitro configurate come edge) non è Node completo: ",[15,16,17],"strong",{},"non puoi assumere"," ",[20,21,22],"code",{},"fs",", ",[20,25,26],{},"child_process",", molti moduli nativi C++ o socket TCP arbitrari. ",[15,29,30],{},"I driver database classici"," (Postgres ",[20,33,34],{},"pg",[20,36,37],{},"mysql2",[20,39,40],{},"better-sqlite3",") richiedono TCP o addon nativi → di solito ",[15,43,44],{},"solo in Node",", non edge.",[11,47,48,49,52,53,56,57,23,60,63,64,67,68,23,75,80],{},"Le chiamate ",[15,50,51],{},"HTTP outbound"," verso API LLM (",[20,54,55],{},"fetch"," verso OpenAI\u002FAnthropic) funzionano spesso da edge, ma restano limiti di ",[15,58,59],{},"CPU",[15,61,62],{},"wall time"," e ",[15,65,66],{},"dimensione bundle",". Consulta sempre le limitazioni aggiornate (es. ",[69,70,74],"a",{"href":71,"rel":72},"https:\u002F\u002Fvercel.com\u002Fdocs\u002Ffunctions\u002Fruntimes\u002Fedge-runtime#limits",[73],"nofollow","Vercel Edge limits",[69,76,79],{"href":77,"rel":78},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fplatform\u002Flimits\u002F",[73],"Cloudflare Workers limits",")—cambiano nel tempo.",[82,83,85],"h2",{"id":84},"edge-cosa-funziona-bene","Edge: cosa funziona bene",[87,88,89,96,105,111],"ul",{},[90,91,92,95],"li",{},[15,93,94],{},"JWT leggero"," (solo decode\u002Fverify con libreria compatibile Web Crypto).",[90,97,98,101,102,104],{},[15,99,100],{},"Rewrite, A\u002FB, geolocation header",", caching ",[20,103,55],{},".",[90,106,107,110],{},[15,108,109],{},"Proxy verso una API Node"," che fa I\u002FO pesante.",[90,112,113,118],{},[15,114,115,116],{},"Chiamate a vendor via ",[20,117,55],{}," con payload moderati.",[82,120,122],{"id":121},"node-cosa-richiede-quasi-sempre","Node: cosa richiede quasi sempre",[87,124,125,134,140],{},[90,126,127,130,131,133],{},[15,128,129],{},"ORM\u002Fdriver SQL"," con pool TCP, ",[20,132,40],{},", Prisma engine, BullMQ, ffmpeg, sharp pesante, file system locale.",[90,135,136,139],{},[15,137,138],{},"Streaming lunghi"," o trasformazioni CPU oltre il budget edge.",[90,141,142,145],{},[15,143,144],{},"Accesso a segreti"," tramite meccanismi che edge non espone uguali (dipende dal provider).",[82,147,149],{"id":148},"pattern-split-consigliato","Pattern split consigliato",[11,151,152],{},"Flusso tipico per un prodotto con auth + LLM + DB:",[154,155,161],"pre",{"className":156,"code":158,"language":159,"meta":160},[157],"language-text","Client → Edge route (auth JWT, rate limit leggero)\n       → fetch interno verso \u002Fapi\u002Fnode\u002F… (region fisso)\n       → Node: query DB + chiamata LLM + logging\n","text","",[20,162,158],{"__ignoreMap":160},[11,164,165,166,169],{},"L’edge riduce latenza per validazione e routing; il ",[15,167,168],{},"lavoro stateful"," resta in Node dove i runtime kits sono maturi.",[82,171,173],{"id":172},"cold-start-e-timeout","Cold start e timeout",[11,175,176,177,180,181,184,185,188,189,192],{},"Edge spesso ha ",[15,178,179],{},"cold start più basso"," per handler minuscoli; Node (serverless) può pagare avvio container + caricamento Prisma. Per la ",[15,182,183],{},"prima richiesta"," dopo idle, misura p95 separatamente per ",[20,186,187],{},"\u002Fedge"," vs ",[20,190,191],{},"\u002Fnode","—non mescolare metriche.",[82,194,196],{"id":195},"checklist-pre-deploy","Checklist pre-deploy",[87,198,201,215,221,227],{"className":199},[200],"contains-task-list",[90,202,205,210,211,214],{"className":203},[204],"task-list-item",[206,207],"input",{"disabled":208,"type":209},true,"checkbox"," Questa route importa moduli con ",[20,212,213],{},"node:"," o path nativi? → Node.",[90,216,218,220],{"className":217},[204],[206,219],{"disabled":208,"type":209}," Devo aprire più di N subrequest sequenziali pesanti? Valuta tutto Node o batch.",[90,222,224,226],{"className":223},[204],[206,225],{"disabled":208,"type":209}," Timeout edge \u003C durata LLM p95? → Node o pattern async (queue + webhook).",[90,228,230,232],{"className":229},[204],[206,231],{"disabled":208,"type":209}," Devo usare WebSocket server verso DB? → Node o servizio gestito.",[82,234,236],{"id":235},"messaggio-di-errore-tipico-nextjs-vercel-edge","Messaggio di errore tipico (Next.js \u002F Vercel Edge)",[11,238,239,240,243,244,23,246,23,248,250],{},"Se importi un modulo ",[15,241,242],{},"Node-only"," (es. ",[20,245,22],{},[20,247,40],{},[20,249,34],{},") in una route Edge, la build o il runtime possono fallire con messaggi nel formato (testo esatto varia per versione Next):",[154,252,255],{"className":253,"code":254,"language":159,"meta":160},[157],"Error: A Node.js API is used (fs) which is not supported in the Edge Runtime.\n",[20,256,254],{"__ignoreMap":160},[11,258,259,260,263,264,104],{},"Oppure, in fase di bundling, trace del tipo ",[15,261,262],{},"“node:fs” \u002F “Module not found: Can't resolve 'fs'”"," verso una dipendenza transitiva. La doc Next.js raggruppa questi casi sotto ",[15,265,266],{},[69,267,270],{"href":268,"rel":269},"https:\u002F\u002Fnextjs.org\u002Fdocs\u002Fmessages\u002Fnode-module-in-edge-runtime",[73],"Node.js Modules in Edge Runtime",[11,272,273,276,277,280,281,283],{},[15,274,275],{},"Fix:"," sposta l’import in una ",[15,278,279],{},"route handler Node"," (o server route Nitro con preset Node) e tieni sull’edge solo ",[20,282,55],{}," \u002F crypto \u002F logica leggera.",[82,285,287],{"id":286},"vercel-edge-limiti-che-influenzano-llm-e-db","Vercel Edge: limiti che influenzano LLM e DB",[11,289,290,291,294,295,298,299,301,302,305,306,309,310,313,314,319,320,323,324,327,328,331],{},"Se deploy su ",[15,292,293],{},"Vercel Edge Functions",", il runtime espone API ",[15,296,297],{},"Web standard"," (",[20,300,55],{},",crypto, streams) ma ",[15,303,304],{},"non"," Node completo—coerente con quanto dice anche la doc Next.js “",[69,307,270],{"href":268,"rel":308},[73],"”. Per limiti ",[15,311,312],{},"numerici"," (CPU, durata, streaming) usa sempre la pagina aggiornata ",[69,315,318],{"href":316,"rel":317},"https:\u002F\u002Fvercel.com\u002Fdocs\u002Ffunctions\u002Fedge-functions\u002Flimitations",[73],"Edge runtime \u002F limitations",": nel 2025 Vercel ha pubblicato changelog su ",[15,321,322],{},"duration"," più lunga per risposte ",[15,325,326],{},"streaming"," (ordine di centinaia di secondi per il flusso) con vincoli sul ",[15,329,330],{},"tempo massimo prima della prima risposta","—rileggi il testo corrente prima di dimensionare timeout LLM.",[11,333,334,335,338],{},"Messaggio pratico del provider: dove servono driver nativi o carico CPU sostenuto, la roadmap aziendale spinge spesso verso ",[15,336,337],{},"Node\u002FFluid compute","; l’edge resta ottimo per routing leggero.",[82,340,342],{"id":341},"nitro-nuxt","Nitro \u002F Nuxt",[11,344,345,346,351,352,355,356,359,360,298,363,23,366,369],{},"In ",[69,347,350],{"href":348,"rel":349},"https:\u002F\u002Fnitro.unjs.io\u002F",[73],"Nitro"," la route è edge solo se deployment e preset lo permettono. Il preset ",[20,353,354],{},"node-server"," predefinito nel vostro progetto è ",[15,357,358],{},"Node",": niente edge implicito. Se in futuro esponi route su edge runtimes, annota esplicitamente quali entrypoint restano ",[15,361,362],{},"server only",[20,364,365],{},"runtimeConfig",[20,367,368],{},"routeRules",").",[82,371,373],{"id":372},"sintesi","Sintesi",[11,375,376,379,380,383],{},[15,377,378],{},"fetch-only, stateless, bassa CPU"," → candidato edge. ",[15,381,382],{},"DB driver, LLM lento, file system, nativi"," → Node. Il ibrido (edge→node interno) è il default sensato per molti SaaS multi-tenant.",{"title":160,"searchDepth":385,"depth":385,"links":386},2,[387,388,389,390,391,392,393,394,395],{"id":84,"depth":385,"text":85},{"id":121,"depth":385,"text":122},{"id":148,"depth":385,"text":149},{"id":172,"depth":385,"text":173},{"id":195,"depth":385,"text":196},{"id":235,"depth":385,"text":236},{"id":286,"depth":385,"text":287},{"id":341,"depth":385,"text":342},{"id":372,"depth":385,"text":373},"\u002Fblog\u002F17_edge_runtime_vs_node_llm_db_routes_1x.webp","Cosa non funziona nelle runtime edge con driver database e chiamate LLM, e come separare le route quando il servizio è già in produzione.",false,"md","it",{},"\u002Fit\u002Fblog\u002Fedge-runtime-vs-node-llm-db-routes","2026-05-23",{"title":5,"description":397},"Edge vs Node: limiti su LLM e database","edge-runtime-vs-node-llm-db-routes","it\u002Fblog\u002Fedge-runtime-vs-node-llm-db-routes",[409],"mvp","-jkWafUsj98nUn11mlRA9fyESadIHJMqiG0n-is0sjQ"]