解决AEM包管理器上传/访问失败问题(权限、网络、URL和运行时限制)
当包未出现、访问被阻止或安装返回未定义消息时,包管理器上载或安装可能会失败。
您可能无法打开包管理器、上载包、查看上载的包或完成安装。 在某些情况下,上载似乎已完成,但包未出现在列表中。 在云环境中,当包中包含运行时不支持的不可变内容时,安装也会失败。
常见原因包括权限缺失、URL不正确、网络限制、浏览器干扰以及包中包含云环境中不可变的路径。 确认访问路径、测试权限和浏览器行为,并查看包过滤器以查找不支持的内容。 仅对可变内容使用运行时包安装,并通过部署管道部署不可变内容。
描述 description
环境:
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- Adobe Experience Manager内部部署
问题/症状:
- 如果在
/crx/packmgr无法访问包管理器,请打开目标环境的正确包管理器URL,并确认/crx/packmgr/index.jsp加载时没有重定向或访问错误。 - 如果包管理器中没有可见的包,请检查具有预期访问权限的其他用户是否可以查看或上传包,以确定该问题是否与权限相关。
- 如果包上载完成,但包未出现在包管理器中,请刷新界面并使用小型测试包重试,以确认是否接受上载并正确显示。
- 如果上传失败且没有清除错误,请从其他网络重试相同的操作,以确定在请求到达AEM之前,防火墙或代理限制是否阻止了该请求。
- 如果浏览器在安装期间显示未定义的错误,请在无痕会话或支持的其他浏览器中重复该操作,以排除扩展、会话或特定于浏览器的干扰。
- 如果云环境因包含不受支持的运行时内容而拒绝包,请检查包过滤器,并确认包仅包含用于运行时安装的可变内容,而不包含不可变路径,如
/apps。
根本原因:
这些故障通常是由以下原因造成的:缺少包路径权限、包管理器URL不正确、网络或防火墙限制、干扰请求的浏览器扩展或会话行为、阻止上传的本地安全工具,或包含云环境中不可变路径(如/apps)的包过滤器。
解决方法 resolution
请尝试以下步骤:
- 打开目标环境的正确包管理器URL,并确认
/crx/packmgr/index.jsp加载时没有重定向或访问错误。 - 通过将结果与预期具有相同访问级别的其他用户进行比较,检查受影响的用户是否有权创建、上传、查看和安装包。
- 如果包管理器未打开或上传未启动,请从其他网络重试相同的操作,以确定防火墙或代理限制是否阻止请求。
- 如果上载或安装在浏览器中失败,请在无痕会话或支持的不同浏览器中重复该操作,以排除扩展、会话或特定于浏览器的干扰。
- 如果同一上传在目标环境和本地SDK中失败,请检查本地或组织安全控制,因为该请求可能会在到达AEM之前被阻止。
- 对于云环境,请查看包过滤器,并确认包仅包含用于运行时安装的可变内容,而不包含不可变路径,如
/apps。 - 如果包包含不可变内容,请通过部署管道而不是包管理器部署该内容。
- 进行更改后,上载一个小型测试包,刷新包管理器,并确认该包出现在列表中且安装时没有出现新错误。
如果在这些检查后问题仍然存在,则在多个浏览器中上传失败时将票证提交到Adobe支持,对于所有用户无法访问包管理器,具有相似访问权限的其他用户可以在受影响用户无法完成操作时完成操作,或者测试显示请求未发送到AEM。 包括屏幕截图、HAR文件、浏览器控制台日志、包名称和故障排除结果摘要。
3d58f420-19b5-47a0-a122-5c9dab55ec7f