fs
3614421eda
- Fix fictional SettingGateway/SettingService references with actual multi-gateway pattern (AdminSettingsService + domain-specific gateways) - Replace non-existent gridQueryLimitOffset()/gridQueryOrderDir() with actual gridParseFiltersFromSchemaFile() - Normalize bin/doctor.php references to canonical bin/console doctor - Add i18n_path contract to module manifest docs - Document module:validate and make:module CLI commands - Add APP_VENDOR_PHP_ISSUES_MODE env var to config reference - Remove invalid label field from notifications module permissions (violates manifest schema additionalProperties: false) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.4 KiB
Fehlerbehebung
Letzte Aktualisierung: 2026-03-14
App reagiert nicht wie erwartet
Symptom
UI zeigt alte Daten/Assets oder Verhalten wirkt stale.
Lösung
docker compose restart php nginx
Erstdiagnose mit Doctor
Symptom
Unklar, ob das Problem aus ENV, DB, Storage, RBAC oder Scheduler kommt.
Lösung
docker compose exec php php bin/console doctor
Bei FAIL zuerst diese Punkte beheben, danach erneut ausführen.
Login/API verhalten sich unerwartet
Symptom
401/403 bei API trotz gültigem Token.
Checks
- Für geschützte Endpunkte Authorization Header korrekt gesetzt (
Bearer <selector:secret>) - Ausnahme:
/api/v1/auth/loginist public und benötigt keinen Bearer-Header - Token nicht revoked/abgelaufen
- Token hat erforderliche Permission
- Bei tenant-scoped Token: Zugriff nur auf passende Tenant-Ressourcen
Migration oder Schema-Probleme
Symptom
Neue Felder/Features fehlen lokal.
Lösung
- Aktuelles Schema in
db/init/init.sqlprüfen - Für Bestandsumgebung idempotentes SQL-Update ausführen
- Danach Container neu starten:
docker compose restart php
Hinweis (Hard Cut 2026-03-14)
Das Update db/updates/2026-03-14-user-bookmarks.sql entfernt user_saved_filters bewusst ohne Migration nach user_bookmarks.
Zusätzlich wurde der alte Bookmark-Icon-Ansatz pro Eintrag entfernt: Icons gelten nur noch auf Gruppenebene (user_bookmark_groups.icon), bestehende Bookmark-Icons werden nicht übernommen.
Wenn gespeicherte Filter noch benötigt werden, vor dem Update ein DB-Backup erstellen.
i18n Fehler
Symptom
Fehlende Translation-Keys oder Mixed-Language UI.
Lösung
docker compose exec php vendor/bin/phpunit --bootstrap vendor/autoload.php tests/I18n/TranslationKeysTest.php
PHPStan/Tests schlagen plötzlich fehl
Symptom
Fehler nach Refactor, obwohl Seite lädt.
Lösung
docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress
docker compose exec php vendor/bin/phpunit --bootstrap vendor/autoload.php
Dann gezielt betroffene Datei/Service prüfen.
Swagger UI lädt ungestylt oder inkonsistent
Symptom
API docs sehen nicht nach App-Theme aus.
Lösung
- Prüfen, dass
Buffer::set('style_groups', json_encode(['api-docs']))gesetzt ist - Prüfen, dass
css/vendor-overrides/swagger-ui.cssüberconfig/assets.phpeingebunden ist - Hard-Reload im Browser