doing-it-website/WIKI-FIX.md

Wiki 404 Error - Fix Dokumentation

Problem

Beim Klick auf den Wiki-Link in der Navbar erscheint ein 404-Fehler auf https://doing-it.de/wiki

Mögliche Ursachen

1. API-Route nicht gefunden: Die API-Route /api/wiki/* wird möglicherweise nicht korrekt deployed
2. Wiki-Service nicht erreichbar: Der Wiki-Service läuft möglicherweise nicht oder ist nicht über das Docker-Netzwerk erreichbar
3. Next.js 14/15 Route-Handling: Probleme mit async params in Next.js 14+

Implementierte Fixes

1. Root-Route für /api/wiki hinzugefügt

• Neue Datei: app/api/wiki/route.ts
• Behandelt direkte Aufrufe zu /api/wiki ohne Pfad

2. Verbessertes Error-Handling

• Bessere Fehlermeldungen in den API-Routes
• Logging für Debugging
• Fehleranzeige in der Wiki-Seite, falls das Wiki nicht lädt

3. Next.js 15 Compatibility

• Async params in Catch-All-Route
• Verbesserte Type-Definitionen

4. Trailing Slash

• Wiki-URL verwendet jetzt /api/wiki/ mit trailing slash

Debugging-Schritte

1. Prüfen ob Wiki-Service läuft

docker-compose ps
docker-compose logs wiki

2. Prüfen ob API-Route erreichbar ist

Direkt im Browser oder mit curl:

curl https://doing-it.de/api/wiki/

3. Prüfen ob Wiki-Service intern erreichbar ist

docker-compose exec web curl http://wiki:8080/

4. Environment-Variable prüfen

Stelle sicher, dass WIKI_SERVICE_URL korrekt gesetzt ist:

docker-compose exec web printenv WIKI_SERVICE_URL

Alternative Lösung: Next.js Rewrite

Falls die API-Route weiterhin Probleme macht, kann ein Next.js Rewrite verwendet werden:

// next.config.js
async rewrites() {
  return [
    {
      source: '/api/wiki/:path*',
      destination: 'http://wiki:8080/:path*',
    },
  ]
}

Dies funktioniert nur server-side und ist möglicherweise zuverlässiger.

Nächste Schritte

1. ✅ Root-Route hinzugefügt
2. ✅ Error-Handling verbessert
3. ✅ Next.js 15 Compatibility
4. ⏳ Testing in Produktion
5. ⏳ Bei Bedarf: Rewrite statt API-Route verwenden