Files
nodeMap/docs/troubleshooting/npm-ci-vs-install.md

1.4 KiB
Raw Blame History

📦 Problem mit Abhängigkeiten und npm-Fehlern

Datum: 17.06.2025

Problem

Nach einem Update oder manuellem Eingriff traten folgende Probleme auf:

  • npm run dev funktionierte nicht mehr.
  • Fehlermeldungen wie Cannot find module 'which, tailwindcss, oder 500er Fehler beim Start.
  • Konflikte in package-lock.json, z.B. bei @mui/material.

🛠️ Lösungsschritte

1. Komplett zurücksetzen

Lösche folgende Ordner und Dateien:

node_modules, package-lock.json, package.json, .next

2. 🧱 Alte funktionierende package-lock.json verwenden

Füge die gesicherte Version wieder ein.

3. 📦 Neu installieren

npm ci

Wichtig: npm ci verwendet exakt die Versionen aus der package-lock.json.

4. 📝 Alte package.json zurückholen

Falls nötig, auch die alte package.json ersetzen.

5. 🚀 Projekt starten

npm run dev

Empfehlung für die Zukunft

  • Immer package.json und package-lock.json sichern, wenn eine Version stabil funktioniert.
  • Husky-Hook verwenden, um Version bei jedem Commit automatisch zu erhöhen.
  • Zusätzlich kannst du node_modules-v1.1.xxx.zip archivieren.

🗂️ Dateiablage

Diese Datei wurde erstellt für zukünftige Referenz und liegt in /docs/troubleshooting/npm-ci-vs-install.md.


Zurück zur Übersicht