Zum Hauptinhalt springen

Troubleshooting

Server-Stack startet nicht​

Prüfen:

  • Existiert das externe Docker-Netz skintogo-reverse-proxy?
  • Liegen docker-compose.yml, docker-compose.server.yml, .env und secrets/ im Zielpfad?
  • Sind Pflicht-Secrets wie db_password und jwt_secret vorhanden?
  • Können GHCR-Images gezogen werden oder ist docker login ghcr.io nötig?

Domain nicht erreichbar​

Wenn Container intern laufen, aber die Domain nicht erreichbar ist:

  • zentralen Reverse Proxy prüfen
  • Reverse-Proxy-Netz prüfen
  • DNS / Cloudflare prüfen
  • Frontend- und Backend-DNS-Aliases prüfen

Backend-Tests schlagen lokal wegen Env fehl​

Tests brauchen die Runtime-Env:

docker compose -f docker-compose.yml -f docker-compose.local.yml exec backend sh -lc '. /usr/local/bin/load-runtime-env.sh && npm test'

Prisma Studio zeigt neue Tabellen oder Typen nicht​

Wenn Prisma Studio lokal noch kein TradeRating zeigt oder User.tradeReputation weiterhin integer ist, obwohl prisma migrate status up to date meldet, ist die lokale _prisma_migrations-Historie vermutlich nicht im Gleichlauf mit dem echten Schema.

Zuerst im laufenden Postgres-Container prüfen, ob Tabelle und Spaltentyp wirklich vorhanden sind, bevor weitere Migrationen erzeugt werden.

Steam Duplicate oder LogonSessionReplaced​

Während der Backend-Service läuft, keine separaten Bot-Logins aus einmaligen Scripts starten. Ein Script, das eine eigene Steam-Bot-Session initialisiert, kann die laufende Backend-Session ersetzen und Fehler wie LogonSessionReplaced oder doppelte Inventarantworten auslösen.

Wenn das rohe Bot-Asset keinen echten Inspect-Link liefert, ist das kein Sonderfall, sondern aktuell der erwartete Steam-Zustand.

Wenn der Browser-Fallback den Link erfolgreich auflöst, ist das der gewünschte Pfad für autoritative Marketplace-Daten.

Wenn auch der Browser-Fallback keinen echten Link liefert, bleibt die Datenquelle der Engpass und der Marktplatz fällt weiter auf Basisdaten zurück.