Experience Modernization Agent疑难解答 troubleshooting
找到故障现象，然后按照其部分操作。 大多数问题都来自对源站点的访问，来自将代码和内容写入到Adobe Experience Manager Edge Delivery Services站点的帐户，或者来自控制台工作区与Git和内容源中保存的内容之间的差异。
在重置、放弃、替换或覆盖任何内容之前，请保留受影响的工作。 代码和内容将分别恢复；请参阅释放、恢复和移交。
如果此页面不能解决问题，请在控制台中请求支持，或在“自动模式”页面中选择获取帮助。
导入失败 import-fails
保留错误和确切的源URL，并检查该URL是否会在浏览器中打开。 如果页面需要登录，或者捕获显示的是登录页面而不是内容，请设置受保护的网站身份验证。 如果源站点阻止自动访问，请参阅具有机器人保护的Source站点。 如果源可以访问，则向代理提供错误并要求它修复该页面的导入。 在重复批处理之前，请重试一个受影响的页面。
具有机器人保护的Source Sites bot-protection
内容分发网络(CDN)或Web应用程序防火墙(WAF)中的机器人保护可以阻止或质询代理在每个工作流中对源站点的请求：URL发现、站点目录、页面捕获和导入。 典型的标志是拒绝访问的错误，如HTTP 403、429或503，发现后缺少URL，页面失败，或捕获的质询或验证页面而不是页面内容。
仅迁移您拥有或有权迁移的站点。 安排与站点管理员的访问，而不是绕过保护：
- 请求管理员允许迁移期间的访问，例如，通过在CDN或WAF中列入允许列表后端地址。
- 如果保护改为接受凭据，如机密请求标头，请在工作流提供的身份验证控件中输入它，如控制台设置中的受保护的站点身份验证。 使用作用域凭据并在迁移完成后将其删除。
- 如果管理员为可访问的暂存主机或源主机提供相同的内容，请将其用作源并记录内容来自何处。
- 如果仅阻止发现，则提供要迁移的页面URL列表。
在启动目录或批量运行之前，请选中一个页面，包括其图像和其他资源。 在访问更改后，重试失败的页面，并在接受内容之前检查捕获是否有质询或访问被拒绝的页面。
允许列表IP地址 allowlist-ip-addresses
经源站点管理员批准，允许列表这些后端地址以进行源提取：
34.228.136.11254.90.51.393.224.194.242
列入允许列表仅提供网络访问：源必须仍可通过Internet访问，并且受保护页面仍需要受保护的站点身份验证。
缺少更改 missing-change
代码和内容会保存在不同的位置，因此请检查每个位置：控制台工作区、上传的内容、推送的分支和预览的页面。 重新导入会覆盖本地内容更改，因此在再次导入页面之前上载或协调编辑。 若要将控制台预览与预览站点进行比较，请参阅控制台预览与站点不同。
控制台预览与站点不同 preview-differs
控制台预览和预览站点呈现内容和代码的不同副本，因为了解您正在查看的结果解释。 查找以下原因之一：
- 未上传的内容：在控制台中更改的页面尚未在Experience Workspace中上传。 通过同步 > 推送 > 内容上载它们。
- 在其他位置编辑的内容：在Experience Workspace中更改的页面尚未在控制台工作区中。 通过同步 > 提取 > 内容提取这些内容，这将覆盖对这些页面的本地编辑；刷新仅重新加载渲染。
- 其他代码：未推送该代码，或者预览URL使用其他分支。 推送代码，然后打开拥有该代码的分行的预览URL。
- 不同的宽度：默认情况下，控制台预览会填充面板。 使用视区菜单在相同的宽度下进行比较。
- 预览网站删除的标记： Edge Delivery Services仅保留部分、块和默认内容，因此页面标记内的样式将丢失。 要求代理将其移动到项目的CSS中。 查看预览的工作方式。
内容写入失败 write-errors
代码和内容使用不同的帐户。 代码是使用您的GitHub连接或其他Git主机的Cloud Manager连接推送的。 使用您登录的Adobe帐户将内容写入Experience Workspace。 因此，如果内容上传失败或者反过来，代码推送可能会成功。
如果上传、拉取或传输指出您的文档创作会话可能已过期，请重新登录并重试。 当会话有效但您的Adobe帐户无权写入网站内容时，控制台会显示相同的消息。 如果这种情况持续存在，请要求站点管理员确认您的帐户（具有您在控制台中使用的电子邮件地址和组织）可以写入Experience Workspace中的站点。 访问Adobe Admin Console中的Experience Manager本身不会授予对网站内容的写入权限。 如果控制台指出您的速率受限，请等待一分钟然后重试。
Git连接问题 git-connection
有关每个GitHub应用程序的作用，请参阅从存储库启动。
https://{branch}--{site}--{organization}.aem.page。有关冲突的更改和受保护的分支，请参阅推送代码更改。
Workspace设置需要一些时间或失败 workspace-setup
准备工作区最多需要10分钟，包括首次登录和重置后。 如果所有工作区都在使用中，控制台会告诉您这一点，并且会在工作区可用后立即开始设置工作区；您无需重试。 如果您更快地需要它，请选择请求支持。 如果设置失败，控制台将请求重试。 如果一直失败，请使用设置屏幕上的 请求支持 链接。 如果控制台指出您的帐户无法使用它，请联系您的Adobe帐户团队。 对于显示 您的工作区已暂停 的工作区，请参阅打开Experience Modernization Console。
项目似乎缺失 missing-workspace
如果您属于多个Adobe组织，则项目可能位于其他组织的控制台工作区中。 注销，然后使用相同的帐户登录，并选择您之前使用的组织的配置文件。 调查时请勿重置工作区：重置会删除您尚未推送的工作。 如果项目仍然缺失，请使用项目名称和预览URL 请求支持。 无论采用哪种方式，推送代码和上传的内容都可在Git存储库和内容源中安全。
发送消息失败 send-failed
无法发送消息。 请重试。 表示控制台无法将您的提示传递给代理。 该消息未提供原因，可能是您的网络连接、登录过期或临时服务问题。
- 请检查网络连接，然后再次发送提示。 控制台不会自动重试。
- 如果再次失败，请复制您的提示，重新加载页面，并在系统询问时登录。 您的聊天历史记录会保留。
- 如果几分钟后仍然失败，请在设置中使用请求支持，并附上失败时间和您的项目名称。
如果控制台改为表示它处于容量状态，请参阅Workspace设置耗时或失败。
删除页面 remove-pages
控制台中的安全保护可阻止代理删除项目内容文件夹中的文件，因此不会错误地删除迁移的内容。 因此，要求代理删除页面不起作用。 自行删除这些区段，并在这些区段存在的每个位置删除：
- 控制台工作区：在内容视图中，选择页面并使用删除，一次删除一个页面。 这将仅删除控制台工作区副本。
- 内容源：删除Experience Workspace中或创作实例上上载的页面。 在执行此操作之前，您在控制台中删除的页面会以云图标重新显示在内容视图中。
- 预览和实时网站：取消发布或删除使用AEM Sidekick预览和发布的页面。
如果页面导入到错误的路径，请再次将其导入到正确的路径，检查这些页面，然后删除位于错误路径的副本。