AUTH301: Konflikt mit Authentifizierungs-Plugin
Was dies bedeutet
Ein anderes Authentifizierungs-Plugin verhindert, dass WCPOS eine Verbindung herstellt.
Bitten Sie den Website-Administrator, den genannten Plugin-Konflikt zu beheben, bevor Sie sich erneut anmelden.
Was zu tun ist
Damit dies funktioniert, ist zuerst eine Änderung der Einstellungen erforderlich. Versuchen Sie es erst nach der oben genannten Änderung erneut; ohne sie schlägt der Versuch genauso fehl.
Ihre Daten
Es sind keine Bestell- oder Produktdaten betroffen. Wenn dies weiterhin auftritt, wenden Sie sich an die Person, die Ihre WordPress-Website betreut.
Fehlerbehebung
- Klappen Sie den Protokolleintrag auf — er nennt das in Konflikt stehende Plugin, sofern der Shop es meldet.
- Bitten Sie den Website-Administrator, die Einstellungen dieses Plugins zu prüfen: Die meisten Authentifizierungs-Plugins können die WCPOS-REST-Routen ausnehmen, statt vollständig deaktiviert zu werden.
- Melden Sie sich nach der Änderung an der Kasse erneut an.
- Wenn unklar ist, welches Plugin den Konflikt verursacht, testen Sie auf einer Staging-Kopie, indem Sie Sicherheits- und Anmelde-Plugins einzeln nacheinander deaktivieren.
Wo Sie nachsehen können
Wenn WCPOS diesen Fehler speichern kann, wird er auf dem Gerät aufgezeichnet, das ihn ausgelöst hat. Öffnen Sie Shop-Zustand → Protokolle (das Herzschlagsymbol unten im Navigationsmenü), suchen Sie den mit diesem Code gekennzeichneten Eintrag und klappen Sie ihn auf: Die aufgeklappte Zeile zeigt die Ursache in verständlicher Sprache sowie den Kontext, der im Moment des Fehlers erfasst wurde. Bei einer Shop-Anfrage kann dieser Kontext den eigenen Fehlercode des Servers (serverCode), den HTTP-status oder den endpoint enthalten; welche Felder angezeigt werden, hängt davon ab, wo der Fehler aufgetreten ist. Verwenden Sie beim Melden eines Problems Debug-Infos kopieren oben im Protokollbildschirm (Debug-Infos teilen auf Smartphones und Tablets) statt Screenshots: Damit werden App-Version, Verbindungsstatus und die neuesten Fehler zusammengefasst. Protokolle werden höchstens 30 Tage aufbewahrt — sammeln Sie sie daher, solange das Problem frisch ist. Kopieren Sie außerdem jede Fehlermeldung aus der Browser-Konsole, die erschienen ist, bevor das POS seinen eigenen Protokolleintrag schreiben konnte.
Über das Protokoll in der App hinaus kann dieser Fehler an folgenden Stellen Spuren hinterlassen:
- Netzwerk-Inspektor (Web und Desktop): Öffnen Sie die Entwicklertools — drücken Sie F12 im Browser oder wählen Sie Erweitert → Entwicklertools umschalten im Menü der Desktop-App — und wechseln Sie zum Tab Netzwerk. Befolgen Sie zuerst die Hinweise zum erneuten Versuch auf dieser Seite; wiederholen Sie die Aktion nur, wenn diese Schritte sie als unbedenklich bezeichnen. Eine fehlgeschlagene Anfrage zeigt den HTTP-Status und den unbearbeiteten Antworttext, einschließlich Fehlerseiten, die nie im POS-Protokoll ankommen.
- Serverseitige POS-Protokolle: Öffnen Sie in WP Admin POS → Einstellungen → Werkzeuge → Protokolle. Diese Seite zeichnet POS-bezogene Warnungen und Fehler auf, die auf dem Server selbst auftreten und möglicherweise nie in der App erscheinen. Ein rotes Abzeichen am Menüeintrag bedeutet, dass ungelesene serverseitige Fehler vorliegen.
- WooCommerce → Status → Protokolle: Prüfen Sie auf der WordPress-Website das neueste
fatal-errors-*.logauf PHP-Abstürze sowie jede Protokollquelle, die nach einem am Fehler beteiligten Plugin benannt ist. Ein Fehler der 500er-Klasse aus dem Shop hinterlässt seine Ursache fast immer hier.
Details
- Code:
AUTH301(AUTH_PLUGIN_CONFLICT) - Schweregrad: error
- Eingeführt in: WCPOS 1.10.0