文档AEMDispatcher 指南

Dispatcher 问题疑难解答 troubleshooting-dispatcher-problems

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Admin
NOTE
虽然 Dispatcher 版本独立于 AEM，但 Dispatcher 文档会嵌入到 AEM 文档中。始终使用嵌入到最新版本的 AEM 文档中的 Dispatcher 文档。
您可能是在单击以前版本的 AEM 文档中嵌入的 Dispatcher 文档链接后重定向到此页面。
NOTE
请查看 Dispatcher 知识库、解决 Dispatcher 刷新问题和 Dispatcher 常见问题解答以了解更多信息。

检查基本配置 check-the-basic-configuration

与往常一样，首要步骤是检查基本情况：

  • 确认基本操作

  • 查看 Web 服务器和 Dispatcher 的所有日志文件。如有必要，可提高用于 Dispatcher 日志记录的 loglevel。

  • 检查您的配置：

    • 您是否有多个 Dispatcher？

      • 您是否已确定哪个 Dispatcher 正在处理您所调查的网站/页面？

    • 您是否已实施过滤器？

      • 这些筛选条件是否影响您调查的事情？

IIS 诊断工具 iis-diagnostic-tools

IIS 提供了各种跟踪工具，具体取决于实际版本：

  • IIS 6 - 可以下载和配置 IIS 诊断工具
  • IIS 7 - 跟踪已完全集成

这些工具可以帮助您监控活动。

IIS 和 404 Not Found iis-and-not-found

在使用 IIS 时，您可能在多种场景下遇到返回 404 Not Found 的情况。如果是这样，请参阅以下知识库文章。

还应检查 Dispatcher 缓存根目录和 IIS 文档根目录是否已设为同一目录。

删除工作流模型时出现问题 problems-deleting-workflow-models

症状

在通过 Dispatcher 访问 AEM 创作实例的情况下尝试删除工作流模型时出现问题。

重现步骤：

  1. 登录到您的创作实例（确认正在通过 Dispatcher 路由请求）。

  2. 创建一个工作流；例如，将“标题”设置为 workflowToDelete。

  3. 确认已成功创建该工作流。

  4. 选择并右键单击该工作流，然后单击​ 删除。

  5. 单击​ 是 ​以确认。

  6. 随后将出现一个错误消息框，其中显示以下内容：
    " ERROR 'Could not delete workflow model!!".

解决方法

将以下标头添加到 dispatcher.any 文件的 /clientheaders 部分：

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

对 mod_dir 的干预 (Apache) interference-with-mod-dir-apache

此过程描述 Dispatcher 如何与 Apache Web Server 中的 mod_dir 进行交互，因为这可能会导致多种有可能意想不到的效果：

Apache 1.3 apache

在 Apache 1.3 中，mod_dir 处理每个这样的请求：其中 URL 映射到文件系统中的某个目录。

它会：

  • 将请求重定向到现有 index.html 文件
  • 生成目录列表

启用 Dispatcher 后，它通过将自身注册为 httpd/unix-directory 内容类型的处理程序而处理此类请求。

Apache 2.x apache-x

在 Apache 2.x 中，情况则有所不同。模块可以处理请求的不同阶段，例如 URL 修复。mod_dir 通过将请求（当 URL 映射到目录时）重定向到追加了 / 的 URL 而处理此阶段。

Dispatcher 不拦截 mod_dir 修复，而是完整地处理对重定向的 URL（即追加了 /）的请求。如果远程服务器（例如 AEM）处理对 /a_path 的请求的方式与处理对 /a_path/ 的请求（当 /a_path 映射到现有目录时）的方式不同，则此过程可能会引发问题。

如果出现这种情况，您必须：

  • 对 Dispatcher 处理的 Directory 或 Location 子树禁用 mod_dir

  • 使用 DirectorySlash Off 配置 mod_dir 以不追加 /

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