61 lines
1.3 KiB
Markdown
61 lines
1.3 KiB
Markdown
# 📦 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:
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
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`.
|