DokumentationAEMDispatcher-Anleitung

Beheben von Problemen beim Dispatcher troubleshooting-dispatcher-problems

Last update: Thu Jul 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
NOTE
Dispatcher-Versionen sind unabhängig von AEM. Die Dispatcher-Dokumentation ist jedoch in die AEM-Dokumentation eingebettet. Verwenden Sie immer die Dispatcher-Dokumentation, die in der Dokumentation für die neueste Version von AEM eingebettet ist.
Möglicherweise wurden Sie auf diese Seite umgeleitet, da Sie einem Link zur Dispatcher-Dokumentation gefolgt sind. Dieser Link ist in die Dokumentation für eine frühere Version von AEM eingebettet.
NOTE
Weitere Informationen finden Sie unter Fehlerbehebung bei Problemen mit dem Leeren des Dispatchers sowie in den häufig gestellten Fragen zu Dispatcher-Problemen.

Überprüfen der Basiskonfiguration check-the-basic-configuration

Wie immer müssen zunächst die Grundlagen überprüft werden:

  • Sicherstellen der grundlegenden Funktion

  • Überprüfen Sie alle Protokolldateien für den Webserver und den Dispatcher. Erhöhen Sie ggf. das loglevel für die Dispatcher-Protokollierung.

  • Überprüfen der Konfiguration:

    • Haben Sie mehrere Dispatcher?

      • Haben Sie ermittelt, welcher Dispatcher die Website/Seite verarbeitet, die Sie prüfen?

    • Haben Sie Filter implementiert?

      • Haben diese Filter Auswirkungen auf den Aspekt, den Sie prüfen?

IIS-Diagnosewerkzeuge iis-diagnostic-tools

IIS bietet verschiedene Werkzeuge für die Ablaufverfolgung, abhängig von der jeweiligen Version:

  • IIS 6: Die IIS-Diagnosewerkzeuge können heruntergeladen und konfiguriert werden.
  • IIS 7: Die Ablaufverfolgung ist vollständig integriert.

Mit diesen Tools können Sie die Aktivität überwachen.

Probleme beim Löschen von Workflow-Modellen problems-deleting-workflow-models

Symptome

Beim Löschen von Workflow-Modellen beim Zugriff auf eine AEM-Autoreninstanz durch den Dispatcher treten Probleme auf.

Zu reproduzierende Schritte:

  1. Melden Sie sich bei der Autoreninstanz an (um zu bestätigen, dass Anfragen über den Dispatcher weitergeleitet werden).

  2. Erstellen Sie einen Workflow, z. B. mit dem Titel „workflowToDelete“.

  3. Vergewissern Sie sich, dass der Workflow erfolgreich erstellt wurde.

  4. Wählen Sie den Workflow aus, klicken Sie mit der rechten Maustaste darauf und klicken Sie dann auf Löschen.

  5. Klicken Sie zur Bestätigung auf Ja.

  6. Es wird ein Fehlermeldungsfeld mit folgenden Informationen angezeigt:
    ERROR 'Could not delete workflow model!!.

Problemlösung

Fügen Sie die folgenden Header im Abschnitt /clientheaders der Datei dispatcher.any hinzu:

  • x-http-method-override
  • x-requested-with
{
{
/clientheaders
{
...
"x-http-method-override"
"x-requested-with"
}

Wechselwirkung mit „mod_dir“ (Apache) interference-with-mod-dir-apache

Dieser Prozess beschreibt, wie der Dispatcher mit mod_dir im Apache-Webserver interagiert, da dies zu verschiedenen, möglicherweise unerwarteten Auswirkungen führen kann:

Apache 1.3 apache

In Apache 1.3 verarbeitet mod_dir alle Anfragen, bei denen die URL auf ein Verzeichnis im Dateisystem verweist.

Es wird eine der folgenden Aktionen ausgeführt:

  • Die Anfrage wird an eine vorhandene index.html-Datei weitergeleitet.
  • Es wird eine Verzeichnisliste erstellt.

Wenn der Dispatcher aktiviert ist, verarbeitet er solche Anfragen, indem er sich selbst als Handler für den Inhaltstyp httpd/unix-directory registriert.

Apache 2.x apache-x

In Apache 2.x sind die Dinge anders. Ein Modul kann die verschiedenen Phasen der Anfrage behandeln, z. B. URL-Korrekturen. mod_dir verarbeitet diese Phase, indem eine Anfrage (wenn die URL einem Ordner zugeordnet ist) an die URL mit angefügtem / weitergeleitet wird.

Der Dispatcher fängt die mod_dir-Korrektur nicht ab, sondern verarbeitet die Anfrage an die umgeleitete URL (d. h. mit angehängtem /) vollständig. Dieser Prozess kann ein Problem darstellen, wenn der Remote-Server (z. B. AEM) Anfragen an /a_path anders als Anfragen an /a_path/ behandelt (wenn /a_path einem vorhandenen Ordner zugeordnet ist).

Wenn dies der Fall ist, müssen Sie einen der beiden folgenden Schritte ausführen:

  • Deaktivieren Sie mod_dir für die Unterstruktur Directory oder Location, die vom Dispatcher verarbeitet wird.

  • Verwenden Sie DirectorySlash Off, um mod_dir so zu konfigurieren, dass / nicht angefügt wird.

recommendation-more-help
ce382601-480f-4a99-8be7-73178d4b6ef5