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

📦 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.