npm: Fehler bei mkdir '/cache' (EROFS / ENOENT) – Ursache & Lösung

Diesen Fehler hatte ich immer wieder bei einem npm update – plötzlich ging gar nichts mehr. Ältere npm-Versionen meldeten ihn etwa so:

npm ERR! code EROFS
npm ERR! syscall mkdir
npm ERR! path /cache
npm ERR! EROFS: read-only file system, mkdir '/cache'

Mit aktuellem npm (getestet mit npm 11 und Node.js 26) sieht dieselbe Ursache etwas anders aus – statt EROFS meldet npm nun ENOENT:

npm error code ENOENT
npm error syscall mkdir
npm error path /cache
npm error enoent ... ENOENT: no such file or directory, mkdir '/cache'
npm error Log files were not written due to an error writing to the directory: /cache/npm/_logs

Die Ursache

In einer der npm-Konfigurationsdateien (npmrc) steht ein Cache-Pfad direkt unter dem Wurzelverzeichnis, zum Beispiel:

cache=/cache/npm

npm versucht dann, den Ordner /cache anzulegen. Das scheitert, weil macOS seit Catalina das System auf einem schreibgeschützten Volume betreibt – direkt unter / lassen sich keine Ordner mehr anlegen, auch nicht mit sudo. Woher der Eintrag kommt, ist oft unklar – bei mir stand er in der ersten Zeile der globalen npmrc von Homebrew (/usr/local/etc/npmrc auf meinem damaligen Intel-Mac).

Diagnose

Konfiguration	Speicherort (Node.js aus Homebrew)
global (Apple Silicon)	/opt/homebrew/etc/npmrc
global (Intel)	/usr/local/etc/npmrc
Benutzer	~/.npmrc
Projekt	.npmrc im Projektordner

Lösung

Den falschen Eintrag einfach entfernen – je nachdem, wo er steht:

npm config delete cache --location=global   # globale npmrc
npm config delete cache --location=user     # ~/.npmrc

Alternativ die Zeile cache=… direkt in der Datei löschen. Danach prüfen:

npm config get cache
# /Users/<name>/.npm

npm verwendet jetzt wieder den Standard-Cache ~/.npm, und npm install bzw. npm update laufen wie gewohnt.