vite-env-only verweigert node:fs mit Intlayer

Wenn du das vite-env-only-Plugin verwendet hast (wie in älteren Empfehlungen von React-Router v7 erwähnt) und Folgendes siehst:

Error: [vite-env-only] Import denied* Denied by specifier pattern: /^node:/* Importer: index.html* Import: "node:fs"

…auch wenn sich kein node:fs in deinem Client-Bundle befindet, handelt es sich um ein false positive.

Was verursacht es

vite-env-only führt eine Babel-basierte Prüfung früh während der Vite-Graphauflösung durch, bevor:

• aliasing (einschließlich Intlayer’s browser vs node mappings),
• Dead-Code-Elimination,
• SSR- vs. Client-Auflösung,
• virtuelle Module wie die von React-Router.

Intlayer-Pakete enthalten Code, der sowohl in Node als auch im Browser funktionieren kann. In einem zwischenzeitlichen Stadium kann ein Node-Builtin wie node:fs im Graph erscheinen, bevor Vite es aus dem Client-Build entfernt. vite-env-only erkennt das und löst sofort einen Fehler aus, obwohl das finale Bundle es nicht enthält.

React-Router und Server-Module

In der React-Router-Dokumentation zu den Konventionen für Server-Module (https://reactrouter.com/api/framework-conventions/server-modules), das Team empfiehlt ausdrücklich die Verwendung von vite-env-only, um zu verhindern, dass serverseitige Importe in das Client-Bundle gelangen.

Diese Konventionen beruhen jedoch auf Vites Aliasing, conditional exports und tree-shaking, um serverseitigen Code zu entfernen. Während Aliasing und conditional exports bereits angewendet werden, sind einige Node-basierte Hilfsfunktionen zu diesem Zeitpunkt in Paketen wie @intlayer/core noch vorhanden (obwohl sie im Client niemals importiert werden). Da das tree-shaking noch nicht ausgeführt wurde, werden diese Funktionen weiterhin von Babel geparst, und vite-env-only erkennt deren node:-Importe und meldet einen False Positive — obwohl sie im finalen Client-Bundle korrekt entfernt werden.

Wie man das behebt / umgeht

Empfehlung: vite-env-only entfernen

Entfernen Sie einfach das Plugin. In vielen Fällen ist es nicht nötig — Vite unterscheidet bereits über seine eigene Auflösung zwischen Client- und Server-Imports.

Damit wird die fälschliche node:fs-Ablehnung behoben, ohne Änderungen an Intlayer.

Stattdessen den finalen Build prüfen

Wenn Sie dennoch sicherstellen möchten, dass keine Node-Built-ins im Client landen, prüfen Sie dies nach dem Build, z. B.:

pnpm buildgrep -R "node:" dist/

Wenn es keine Ergebnisse gibt, sind Ihre Client-Bundles sauber.

Zusammenfassung

• vite-env-only kann bei node:fs einen Fehler melden, weil es zu früh prüft.
• Vite + Intlayer + die Server-Module-Konventionen von React-Router entfernen normalerweise Server-only-Referenzen korrekt.
• Das Entfernen des Plugins oder die Überprüfung der finalen Ausgabe ist in der Regel die beste Lösung.