疑难解答 troubleshooting
本节包含可帮助您进行故障诊断的日志的详细信息，还包含有关您在AEM中可能遇到的一些问题的信息。
创作性能疑难解答 troubleshoot-author-performance
在创作实例上分析缓慢的性能可能会变得相当复杂。 第一步需要确定性能下降的技术堆栈级别。
以下决策树为缩小瓶颈提供了指导。
基本优化 basic-optimization
配置日志文件和审核日志 configuring-log-files-and-audit-logs
AEM记录您可能需要配置的详细日志，以便对安装问题进行故障诊断。 有关信息，请参阅 使用审核记录和日志文件 中。
使用详细选项 using-the-verbose-option
启动AEM WCM时，可以向命令行中添加 — v(verbose)选项，如下所示：java -jar cq-wcm-quickstart-<version>.jar -v.
详细选项在控制台上显示一些快速启动日志输出，以便用于疑难解答。
常见安装问题 common-installation-issues
以下部分介绍一些安装问题及其解决方案。
双击快速入门Jar不起任何作用，或者使用其他程序（例如，存档管理器）打开Jar文件 double-clicking-the-quickstart-jar-does-not-have-any-effect-or-opens-the-jar-file-with-another-program-for-example-archive-manager
这通常表示将操作系统的桌面环境配置为打开扩展名为.jar的文件时出现问题。 它还可能表示您未安装Java，或者您使用的是不受支持的Java版本。
由于jar文件使用无处不在的ZIP格式，因此某些存档程序可能会自动将桌面配置为将jar文件作为存档文件打开。
要进行故障诊断，请执行以下操作：
-
再次检查您是否至少安装了Java版本1.6。
-
在AEM WCM快速入门中尝试使用上下文菜单（通常单击鼠标右键），然后选择“打开方式……”."
-
检查是否列出了Java或Sun Java，然后尝试使用它运行AEM WCM。 如果安装了多个Java版本，请选择支持的版本。
如果此步骤成功，并且您的操作系统提供了始终使用选定程序运行.jar文件的选项，请选择它。 此后，双击应该可以正常工作。
-
有时重新安装支持的Java版本有助于恢复正确的关联。
-
您始终可以使用命令行或启动/停止脚本来运行CRX，如本文档前面所述。
我在CRX上运行的应用程序会引发内存不足错误 my-application-running-on-crx-throws-out-of-memory-errors
CRX公司自身的内存占用空间非常小。 如果在CRX中运行的应用程序具有较大的内存要求或请求内存密集型操作（例如，大型事务），则需要使用适当的内存设置启动运行CRX的JVM实例。
使用Java命令选项定义JVM的内存设置（例如，java -Xmx512m -jar crx*.jar将heapsize设置为512MB）。
从命令行启动AEM WCM时指定内存设置选项。 还可以修改AEM WCM启动/停止脚本或用于管理AEM WCM启动的自定义脚本，以定义所需的内存设置。
如果已将堆大小定义为512MB，则可能需要通过创建堆转储进一步分析内存问题：
要在内存不足时自动创建堆转储，请使用以下命令：
java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar *.jar
这会生成堆转储文件(java_…hprof)。 在生成堆转储后，该进程可能会继续运行。 通常，一个堆转储文件就足以分析问题。
双击“AEM快速入门”后，浏览器中不会显示“AEM欢迎”屏幕 the-aem-welcome-screen-does-not-display-in-the-browser-after-double-clicking-aem-quickstart
在某些情况下，即使存储库本身成功运行，AEM WCM欢迎屏幕也不会自动显示。 这可能取决于操作系统设置、浏览器配置或类似因素。
常见症状是“AEM WCM快速启动”窗口显示“AEM WCM正在启动，正在等待服务器启动……." 如果该消息显示时间较长，请使用默认的4502端口或运行实例的端口手动将AEM WCM URL输入到浏览器窗口中：http://localhost:4502/。
此外，日志可能还会显示浏览器未启动的原因。
有时，AEM WCM快速启动窗口会显示消息“AEM WCM正在http://localhost:port/上运行”，并且浏览器不会自动启动。 在这种情况下，单击AEM WCM快速入门窗口中的URL（它是超链接），或在浏览器中手动输入该URL。
如果其他所有操作都失败，请检查日志以了解发生了什么。
使用应用程序服务器对安装进行故障排除 troubleshooting-installations-with-an-application-server
请求geometrixx-outdour页面时返回“页面未找到” page-not-found-returned-when-requesting-a-geometrixx-outdoor-page
适用于WebLogic 10.3.5和JBoss 5.1
当对geometrixx-outdoors/en页面的请求返回404（页面未找到）时，您可以重新检查是否已在这些特定应用程序服务器所需的sling.properties文件中设置附加sling属性。
请参阅 部署AEM Web应用程序 详细信息的步骤。
响应标头大小可以大于4 Kb response-header-size-can-be-greater-than-kb
502错误可能表示Web服务器无法处理AEM HTTP响应标头的大小。 AEM可以生成包含大于4Kb的Cookie的HTTP响应标头。 确保配置了Servlet容器，以便最大响应标头大小可以超过4kb。
例如，对于Tomcat 7.0, HTTP Connector 控制标头大小的限制。
卸载Adobe Experience Manager uninstalling-adobe-experience-manager
由于AEM安装到单个目录中，因此无需卸载实用程序。 卸载操作与删除整个安装目录一样简单，不过卸载AEM的方式取决于您要实现的内容以及您使用的永久存储。
如果永久存储嵌入在安装目录中，例如，在默认的TarPM安装中，删除文件夹也会删除数据。
如果您的AEM安装使用外部存储（例如，数据库服务器），则删除文件夹不会自动删除数据，但会删除存储配置，这会使恢复JCR内容变得困难。
JSP文件未在JBoss上编译 jsp-files-are-not-compiled-on-jboss
如果安装或更新JSP文件以在JBoss上Experience Manager，并且未编译相应的Servlet，请确保正确配置了JBoss JSP编译器。 有关信息，请参阅
JBoss中的JSP编译问题 文章。