Azure 存储资源管理器故障排除指南

  • 项目

注意

本文是否有帮助？ 你的输入对我们很重要。 请使用此页面上的 “反馈 ”按钮，让我们了解本文对你的影响，或者我们如何改进它。

Microsoft Azure 存储资源管理器是一个独立应用，可用于在 Windows、macOS 和 Linux 上轻松处理 Azure 存储数据。 应用可以连接到 Azure、国家云和 Azure Stack 上托管的存储帐户。

本指南总结了存储资源管理器中常见的问题的解决方案。

Azure RBAC 权限问题

Azure 基于角色 的访问控制 (Azure RBAC) 通过将权限集合并到角色中，实现了对 Azure 资源的精细访问管理。 下面是一些策略，可让 Azure RBAC 在存储资源管理器中以最佳方式工作。

如何实现访问 存储资源管理器 中的资源？

如果在通过 Azure RBAC 访问存储资源时遇到问题，则可能尚未分配相应的角色。 以下部分介绍存储资源管理器当前访问存储资源所需的权限。 如果不确定自己具有适当的角色或权限，请与 Azure 帐户管理员联系。

“读取：列出/获取存储帐户 () ”权限问题

必须具有列出存储帐户的权限。 若要获取此权限，必须为你分配“读者”角色。

列出存储帐户密钥

存储资源管理器还可以使用帐户密钥对请求进行身份验证。 可以通过更强大的角色（例如参与者角色）访问帐户密钥。

注意

访问密钥向持有这些密钥的任何人授予不受限制的权限。 因此，不建议将这些密钥分发给帐户用户。 如果需要撤销访问密钥，可以从Azure 门户重新生成访问密钥。

数据角色

必须为你分配至少一个角色，该角色授予从资源读取数据的权限。 例如，如果要列出或下载 Blob，至少需要存储 Blob 数据读取者角色。

为什么我需要一个管理层角色才能在 存储资源管理器 中查看我的资源？

Azure 存储具有两层访问权限：管理和数据。 订阅和存储帐户通过管理层进行访问。 容器、Blob 和其他数据资源通过数据层进行访问。 例如，如果要从 Azure 获取存储帐户的列表，请向管理终结点发送请求。 如果需要帐户中的 Blob 容器列表，请将请求发送到相应的服务终结点。

Azure 角色可以授予管理或数据层访问权限。 例如，读者角色授予对管理层资源的只读访问权限。

严格地说，读取者角色不提供任何数据层权限，也不需要访问数据层。

存储资源管理器，通过收集连接到 Azure 资源所需的信息，可以轻松访问资源。 例如，若要显示 Blob 容器，存储资源管理器向 Blob 服务终结点发送“列表容器”请求。 若要获取该终结点，存储资源管理器搜索有权访问的订阅和存储帐户列表。 若要查找订阅和存储帐户，存储资源管理器还需要访问管理层。

如果没有授予任何管理层权限的角色，存储资源管理器无法获取连接到数据层所需的信息。

如果我无法从管理员那里获取所需的管理层权限，该怎么办？

如果要访问 blob 容器、Azure Data Lake Storage Gen2容器、目录或队列，可以使用 Azure 凭据附加到这些资源。

  1. 打开“ 连接 ”对话框。
  2. 选择要连接到的资源类型。
  3. 选择“使用 Microsoft Entra ID>下一步登录”。
  4. 选择与要附加到的资源关联的用户帐户和租户，然后选择“ 下一步”。
  5. 键入资源的 URL，然后键入连接的唯一显示名称。 选择“ 下一步>连接”。

目前，没有适用于其他资源类型的 Azure RBAC 相关解决方案。 解决方法是，可以请求共享访问签名 URL，然后将其附加到资源：

  1. 打开“ 连接 ”对话框。
  2. 选择要连接到的资源类型。
  3. 选择“ 共享访问签名 (SAS) >下一步”。
  4. 键入收到的共享访问签名 URL，并为连接输入唯一的显示名称。 选择“ 下一步>连接”。

有关如何附加到资源的详细信息，请参阅 附加到单个资源。

多个 Azure 内置角色可以提供使用存储资源管理器所需的权限。 其中一些角色包括：

注意

所有者、参与者和存储帐户参与者角色授予帐户密钥访问权限。

SSL 证书问题

本部分讨论 SSL 证书问题。

了解 SSL 证书问题

在继续操作之前，请确保已阅读存储资源管理器网络文档中的 SSL 证书部分。

使用系统代理

如果仅使用支持 使用系统代理 设置的功能，请尝试使用该设置。 若要详细了解系统代理设置，请参阅 存储资源管理器 中的网络连接。

导入 SSL 证书

如果有自签名证书的副本，可以指示存储资源管理器信任它们：

  1. 获取证书副本的 Base-64 编码 X.509 (.cer) 。
  2. 转到 “编辑>SSL 证书>”“导入证书”。 然后使用文件选取器查找、选择和打开.cer文件。

如果有多个证书 (根和中间) ，也可能会出现此问题。 若要修复此错误，必须导入所有证书。

查找 SSL 证书

如果没有自签名证书的副本，请向 IT 管理员寻求帮助。

请按照以下步骤查找它们：

  1. 安装 OpenSSL：

    • Windows：任何精简版本都应足够。
    • Mac：操作系统中应包含 OpenSSL。
    • Linux：操作系统中应包含 OpenSSL。

  2. 运行 OpenSSL：

    • Windows：打开安装目录，选择 /bin/，然后双击“openssl.exe”。
    • Mac：从终端运行 openssl 。
    • Linux：从终端运行 openssl 。

  3. 为存储资源落后的任何 Microsoft 或 Azure 主机名运行 命令 openssl s_client -showcerts -connect <hostname>:443 。 有关详细信息，请参阅存储资源管理器经常访问的主机名列表。

  4. 查找自签名证书。 如果使用者 ("s:") 和颁发者 ("i:") 相同，则证书很可能是自签名证书。

  5. 找到每个自签名证书时，请将从 -----BEGIN CERTIFICATE----------END CERTIFICATE----- 到 的所有证书复制并粘贴到新的.cer文件中。

  6. 打开存储资源管理器，转到“编辑>SSL 证书>”“导入证书”。 然后使用文件选取器查找、选择和打开创建的.cer文件。

禁用 SSL 证书验证

如果按照这些步骤找不到任何自签名证书，请通过反馈工具与我们联系。 还可以使用 --ignore-certificate-errors 标志从命令行打开存储资源管理器。 使用此标志打开时，存储资源管理器会忽略证书错误。 不建议使用此标志。

登录问题

本部分讨论可能会遇到的登录问题。

了解登录

在继续操作之前，请确保已阅读登录存储资源管理器文档。

经常需要重新输入凭据

必须重新输入凭据很可能是由Microsoft Entra管理员设置的条件访问策略的结果。当存储资源管理器要求你从帐户面板中重新输入凭据时，应会看到“错误详细信息”链接。 选择它以查看存储资源管理器要求你重新输入凭据的原因。 需要重新输入凭据的条件访问策略错误可能如下所示：

  • 刷新令牌已过期。
  • 必须使用多重身份验证才能访问。
  • 管理员进行了配置更改。

若要降低由于出现上述错误而必须重新输入凭据的频率，请与Microsoft Entra管理员联系。

条件访问策略

如果帐户需要满足条件访问策略，请确保对“使用登录”设置使用默认 Web 浏览器值。 有关该设置的信息，请参阅 更改登录发生位置。

浏览器在登录期间抱怨 HTTP 重定向或连接不安全

存储资源管理器在 Web 浏览器中执行登录时，会在登录过程结束时重定向到 localhost。 浏览器有时会引发警告或错误，指示使用 HTTP 而不是 HTTPS 执行重定向。 某些浏览器可能还会尝试强制使用 HTTPS 执行重定向。 如果发生以下任一问题，则根据浏览器的不同，可以选择：

  • 忽略警告。
  • 为 localhost 添加例外。
  • 禁用强制 HTTPS（全局或仅针对 localhost）。

如果无法执行任何这些选项，还可以 更改集成登录发生的位置 ，以避免完全使用浏览器。

无法获取令牌，租户被筛选掉

有时，你可能会看到一条错误消息，指出无法获取令牌，因为租户被筛选掉。这意味着你正在尝试访问已筛选掉的租户中的资源。若要包含租户，请转到 帐户面板。 确保选中错误中指定的租户的复选框。 有关在 存储资源管理器 中筛选租户的详细信息，请参阅管理帐户。

身份验证库无法正确启动

如果在启动时看到错误消息，指出存储资源管理器的身份验证库无法正确启动，请确保安装环境满足所有先决条件。 不符合先决条件是出现此错误消息的最可能原因。

如果认为安装环境满足所有先决条件，请在 GitHub 上提出问题。 打开问题时，请确保包括：

  • 你的 OS。
  • 尝试使用的存储资源管理器版本。
  • 是否检查了先决条件。
  • 存储资源管理器启动失败的身份验证日志。 发生此类错误后，会自动启用详细身份验证日志记录。

使用集成登录时的空白窗口

如果选择使用 集成登录 ，并且看到空白登录窗口，可能需要切换到其他登录方法。 当Active Directory 联合身份验证服务服务器提示存储资源管理器执行 Electron 不支持的重定向时，通常会出现空白登录对话框。

若要更改为其他登录方法，请更改“设置”“应用程序>登录”下的“使用登录”>设置。 有关不同类型的登录方法的信息，请参阅 更改登录发生位置。

重新身份验证循环或 UPN 更改

如果你处于重新身份验证循环中，或者已更改其中一个帐户的 UPN，请尝试以下步骤：

  1. 打开存储资源管理器。
  2. 转到 “帮助>重置”。
  3. 确保至少选择了 “身份验证 ”。 清除不想重置的其他项目。
  4. 选择“重置”。
  5. 重启存储资源管理器，然后再次尝试登录。

如果在重置后仍遇到问题，请尝试以下步骤：

  1. 打开存储资源管理器。
  2. 删除所有帐户，然后关闭存储资源管理器。
  3. 删除 。计算机的 IdentityService 文件夹。 在 Windows 上，文件夹位于 C：\users\<username>\AppData\Local。 对于 Mac 和 Linux，可以在用户目录的根目录中找到 文件夹。
  4. 如果运行的是 Mac 或 Linux，则还需要从操作系统的密钥存储中删除 Microsoft.Developer.IdentityService 条目。 在 Mac 上，密钥存储是 Gnome 密钥链应用程序。 在 Linux 中，应用程序通常称为 Keyring，但名称可能因分发版而异。
  5. 重启存储资源管理器，然后再次尝试登录。

macOS：密钥链错误或无登录窗口

macOS 密钥链有时会进入导致存储资源管理器身份验证库出现问题的状态。 若要使密钥链脱离此状态，请执行以下步骤：

  1. 关闭存储资源管理器。

  2. 通过选择“命令 + 空格键”打开“密钥链”，键入“密钥链”，然后选择“Enter”。

  3. 选择登录密钥链。

  4. 选择挂锁以锁定密钥链。 该过程完成后， 挂锁 显示为锁定。 可能需要几秒钟时间，具体取决于打开的应用。

    显示挂锁的屏幕截图。

  5. 打开存储资源管理器。

  6. 系统会提示“服务中心想要访问密钥链”等消息。键入 Mac 管理员帐户密码，然后选择“ 始终允许”。 或者，如果“始终允许”不可用，请选择“允许”。

  7. 尝试登录。

Linux：启动时没有应用程序窗口或密码管理器错误

如果在 Linux 系统上启动存储资源管理器，可能会遇到以下问题之一：

  • 未显示应用程序窗口。
  • 发生有关系统密码管理器的错误。

存储资源管理器使用系统的凭据管理器来保护数据，包括登录凭据和 SAS 连接。 如果未检测到兼容的凭据管理器应用程序，存储资源管理器将不会启动。 如果系统未安装本地凭据管理工具，请安装与 libsecret兼容的第三方工具。 例如，在使用 GNOME 桌面环境的 Linux 系统上，可以安装 Seahorse。

如果启动时不存在，存储资源管理器通常会创建默认密钥环。 但是，在某些情况下，这种情况可能不会发生，导致没有应用程序窗口或密码管理器服务错误。 若要解决问题，请手动设置默认密钥环。

如果你使用的是 Seahorse 并且没有现有的密钥环，或者想要创建新的密钥环，请按照以下步骤创建默认密钥环：

  1. 启动“密码和密钥”应用程序。
  2. 选择“+”按钮，然后选择 “密码密钥环”。
  3. 为新密钥环设置名称和密码。
  4. 右键单击新密钥环，然后选择“ 设置为默认值”。

如果使用存储资源管理器快照，还必须确保存储资源管理器已连接到系统的密码管理器。 为此，请运行下列命令：

snap connect storage-explorer:password-manager-service :password-manager-service

默认浏览器无法打开

如果尝试登录时默认浏览器未打开，请尝试以下所有方法：

  • 重启存储资源管理器。
  • 在开始登录之前，请手动打开浏览器。
  • 尝试使用 集成登录。 有关说明，请参阅 更改登录发生位置。

其他登录问题

如果上述说明均不适用于你的登录问题，或者它们无法解决你的登录问题，请在 GitHub 上打开问题。

缺少订阅和损坏的租户

如果在成功登录后无法检索订阅，请尝试以下故障排除方法：

  • 验证帐户是否有权访问所需的订阅。 可以通过登录到尝试使用的 Azure 环境的门户来验证访问权限。
  • 请确保已通过正确的 Azure 环境（如 Azure、Azure 中国世纪互联、Azure 德国、Azure 美国政府或自定义环境）登录。
  • 如果位于代理服务器后面，请确保正确配置了存储资源管理器代理。
  • 尝试删除并添加回帐户。
  • 如果存在“更多信息”或“错误详细信息”链接，检查失败的租户报告哪些错误消息。 如果不确定如何响应错误消息，请在 GitHub 中打开问题。

在 AzCopy 传输期间与 OS 凭据存储交互时出现问题

如果在 Windows 上看到此消息，则 Windows 凭据管理器很可能已满。 若要在 Windows 凭据管理器中腾出空间，请执行以下步骤：

  1. 关闭存储资源管理器。
  2. 在 “开始 ”菜单上，搜索 “凭据管理器” 并将其打开。
  3. 转到 Windows 凭据。
  4. 在 “通用凭据”下，查找与不再使用的程序关联的条目，并将其删除。 还可以查找等 azcopy/aadtoken/<some number> 条目，并删除这些条目。

如果在完成上述步骤后继续显示该消息，或者在 Windows 以外的平台上遇到此消息，则可以 在 GitHub 上打开问题。

无法删除附加的存储帐户或资源

如果无法通过 UI 删除附加的帐户或存储资源，可以通过删除以下文件夹来手动删除所有附加的资源：

  • Windows： %AppData%/StorageExplorer
  • macOS： /Users/<your_name>/Library/Application Support/StorageExplorer
  • Linux： ~/.config/StorageExplorer

在删除这些文件夹之前关闭存储资源管理器。

注意

如果曾经导入过任何 SSL 证书，请备份 证书 目录的内容。 稍后，可以使用备份重新导入 SSL 证书。

代理问题

存储资源管理器支持通过代理服务器连接到 Azure 存储资源。 如果通过代理连接到 Azure 时遇到任何问题，下面是一些建议。

存储资源管理器仅支持对代理服务器进行基本身份验证。 不支持其他身份验证方法，例如 NTLM。

注意

存储资源管理器不支持用于配置代理设置的代理自动配置文件。

验证存储资源管理器代理设置

应用程序>代理>代理配置设置确定从哪个源存储资源管理器获取代理配置。

如果选择“ 使用环境变量”，请确保设置 HTTPS_PROXY 或 HTTP_PROXY 环境变量。 环境变量区分大小写，因此请务必设置正确的变量。 如果这些变量未定义或无效，存储资源管理器将不会使用代理。 修改任何环境变量后，重启存储资源管理器。

如果选择“ 使用应用代理设置”，请确保应用内代理设置正确。

诊断问题的步骤

如果仍然遇到问题，请尝试以下故障排除方法：

  1. 如果无需使用代理即可连接到 Internet，请验证存储资源管理器在未启用代理设置的情况下正常工作。 如果存储资源管理器连接成功，则代理服务器可能存在问题。 请与管理员协作，确定问题。
  2. 验证使用代理服务器的其他应用程序是否按预期工作。
  3. 验证是否可以连接到尝试使用的 Azure 环境的门户。
  4. 验证是否可以从服务终结点接收响应。 在浏览器中输入一个终结点 URL。 如果可以连接，应会收到 InvalidQueryParameterValue 或类似的 XML 响应。
  5. 检查将存储资源管理器与同一代理服务器配合使用的其他人是否可以连接。 如果可以，可能需要联系代理服务器管理员。

用于诊断问题的工具

网络工具（如 Fiddler）可以帮助你诊断问题。

  1. 将网络工具配置为在本地主机上运行的代理服务器。 如果必须继续在实际代理后面工作，则可能必须配置网络工具以通过代理进行连接。
  2. 检查网络工具使用的端口号。
  3. 配置存储资源管理器代理设置以使用本地主机和网络工具的端口号，例如 localhost:8888。

正确设置后，网络工具会记录存储资源管理器对管理和服务终结点发出的网络请求。

如果网络工具似乎未记录存储资源管理器流量，请尝试使用其他应用程序测试工具。 例如，输入其中一个存储资源的终结点 URL，例如 https://contoso.blob.core.windows.net/ 在 Web 浏览器中。 你将收到类似于以下代码示例的响应：

<?xml version="1.0" encoding="UTF-8"?>
<Error>
    <Code>InvalidQueryParameterValue</Code>
    <Message>Value for one of the query parameters specified in the request URI is invalid.
        RequestId:<RequestId> Time:2017-04-10T21:42:17.3863214Z</Message>
    <QueryParameterName>comp</QueryParameterName>
    <QueryParameterValue/>
    <Reason/>
</Error>

响应表明资源存在，即使你无法访问它。

如果网络工具仅显示来自其他应用程序的流量，则可能需要在 存储资源管理器 中调整代理设置。 否则，可能需要调整工具的设置。

联系代理服务器管理员

如果代理设置正确，则可能需要联系代理服务器管理员以：

  • 请确保代理不会阻止流向 Azure 管理或资源终结点的流量。
  • 验证代理服务器使用的身份验证协议。 存储资源管理器仅支持基本身份验证协议。 存储资源管理器不支持 NTLM 代理。

“无法检索子级”错误消息

如果通过代理连接到 Azure，请验证代理设置是否正确。

如果订阅或帐户的所有者已授予你访问某个资源的权限，请验证你是否对该资源具有读取权限或列出权限。

连接字符串没有完整的配置设置

如果收到此错误消息，则可能没有获取存储帐户密钥所需的权限。 若要确认，请转到门户并找到存储帐户。 右键单击存储帐户的节点，然后选择“ 在门户中打开”。 然后，转到“ 访问密钥 ”窗格。 如果你没有查看密钥的权限，你将看到“你没有访问权限”消息。 若要解决此问题，可以获取帐户名称和密钥或帐户共享访问签名，然后使用它附加存储帐户。

如果确实看到帐户密钥，请在 GitHub 中提交问题，以便我们帮助您解决问题。

“添加新连接时出错：TypeError：无法读取未定义的属性'版本'”

如果在尝试添加自定义连接时收到此错误消息，则存储在本地凭据管理器中的连接数据可能已损坏。 若要解决此问题，请尝试删除并添加回损坏的本地连接：

  1. 启动存储资源管理器。 从菜单中，转到 “帮助>切换开发人员工具”。

  2. 在打开的窗口中，在“ 应用程序 ”选项卡上，转到左侧的 “本地存储>file:// ”。

  3. 根据遇到问题的连接类型，查找其密钥。 然后将其值复制到文本编辑器中。 值是自定义连接名称的数组，例如：

    • 存储帐户
      • StorageExplorer_CustomConnections_Accounts_v1
    • Blob 容器
      • StorageExplorer_CustomConnections_Blobs_v1
      • StorageExplorer_CustomConnections_Blobs_v2
    • 文件共享
      • StorageExplorer_CustomConnections_Files_v1
    • 队列
      • StorageExplorer_CustomConnections_Queues_v1
    • 表格
      • StorageExplorer_CustomConnections_Tables_v1

  4. 保存当前连接名称后，将 开发人员工具 中的值设置为 []。

若要保留未损坏的连接，请使用以下步骤查找损坏的连接。 如果不介意丢失所有现有连接，请跳过这些步骤，并按照特定于平台的说明清除连接数据。

  1. 在文本编辑器中，将每个连接名称重新添加到 开发人员工具。 然后检查连接是否仍在工作。
  2. 如果连接正常工作，则它未损坏;你可以放心地把它留在那里。 如果连接不起作用，请从 开发人员工具中删除其值并记录它，以便稍后可以重新添加它。
  3. 重复此操作，直到检查完所有连接。

删除连接名称后，必须清除其损坏的数据。 然后，可以使用 存储资源管理器 中的标准连接步骤重新添加连接。

  1. 在 “开始 ”菜单上，搜索 “凭据管理器” 并将其打开。
  2. 转到 Windows 凭据。
  3. 在 “通用凭据”下，查找具有密钥的 <connection_type_key>/<corrupted_connection_name> 条目。 例如 StorageExplorer_CustomConnections_Accounts_v1/account1。
  4. 删除并重新添加这些连接。

如果在运行这些步骤后仍遇到此错误，或者想要共享怀疑已损坏连接的内容，请在 GitHub 页面上 打开问题 。

共享访问签名 URL 的问题

如果通过共享访问签名 URL 连接到服务，但遇到错误：

  • 验证 URL 是否提供读取或列出资源所需的权限。
  • 验证 URL 是否未过期。
  • 如果共享访问签名 URL 基于访问策略，请验证访问策略是否已撤销。

如果使用无效的共享访问签名 URL 意外附加，现在无法分离，请执行以下步骤：

  1. 运行存储资源管理器时，选择 F12 打开“开发人员工具”窗口。
  2. 在“ 应用程序 ”选项卡上，选择左侧的“ 本地存储>file:// ”。
  3. 查找与共享访问签名 URI 的服务类型关联的密钥。 例如，如果错误的共享访问签名 URI 适用于 Blob 容器，请查找名为 的 StorageExplorer_AddStorageServiceSAS_v1_blob密钥。
  4. 键的值应为 JSON 数组。 找到与错误 URI 关联的对象，并将其删除。
  5. 选择 Ctrl +R 以重新加载存储资源管理器。

存储资源管理器依赖项

存储资源管理器附带在 Windows 上运行所需的所有依赖项。

较新版本的 .NET Core 的修补程序存储资源管理器

对于 存储资源管理器 1.7.0 或更低版本，可能需要修补 存储资源管理器 使用的 .NET Core 版本：

  1. 转到 NuGet 页面，并从右侧的下载 包 链接下载 1.5.43 版 StreamJsonRpc。

  2. 下载包后，将其文件扩展名从 .nupkg 更改为 .zip。

  3. 解压缩包。

  4. 打开 streamjsonrpc.1.5.43/lib/netstandard1.1/ 文件夹。

  5. 将StreamJsonRpc.dll 复制到 存储资源管理器 文件夹中的以下位置：

    • StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService/
    • StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64/

Azure 门户中的“在资源管理器中打开”按钮不起作用

如果Azure 门户中的“在资源管理器中打开”按钮不起作用，请确保使用兼容的浏览器。 以下浏览器已经过兼容性测试：

  • Microsoft Edge
  • Mozilla Firefox
  • Google Chrome
  • Microsoft Internet Explorer

收集日志

向 GitHub 报告问题时，系统可能会要求你收集某些日志以帮助诊断问题。

存储资源管理器日志

存储资源管理器将各种内容记录到自己的应用程序日志中。 可以通过选择“ 帮助>打开日志目录”轻松访问这些日志。 默认情况下，存储资源管理器日志的详细程度较低。 若要更改详细级别，请转到 设置 (左侧的 齿轮 符号) >应用程序>日志记录>日志级别。 然后，可以根据需要设置日志级别。 对于故障排除，建议使用调试日志级别。

日志将拆分为运行的每个存储资源管理器会话的文件夹。 对于需要共享的任何日志文件，请将它们放置在 zip 存档中，不同会话中的文件位于不同的文件夹中。

身份验证日志

对于与登录或存储资源管理器身份验证库相关的问题，你很可能需要收集身份验证日志。 身份验证日志存储在：

  • Windows： C：\Users\<your username>\AppData\Local\Temp\servicehub\logs
  • macOS： ~/。ServiceHub/logs
  • Linux： ~/。ServiceHub/logs

通常，可以按照以下步骤收集日志：

  1. 转到“设置”， (应用程序>登录) 左侧>的齿轮符号。 选择“ 详细身份验证日志记录”。 如果存储资源管理器由于身份验证库问题而无法启动，则此步骤将为你完成。
  2. 关闭存储资源管理器。
  3. 可选/建议：从 logs 文件夹中清除现有日志。 此步骤可减少需要向我们发送的信息量。
  4. 打开存储资源管理器并重现问题。
  5. 关闭存储资源管理器。
  6. 压缩 logs 文件夹的内容。

AzCopy 日志

如果在传输数据时遇到问题，可能需要获取 AzCopy 日志。 可以通过两种不同的方法轻松找到 AzCopy 日志：

  • 对于仍然在活动日志中失败的传输，请选择“ 转到 AzCopy 日志文件”。

  • 对于过去失败的传输，请转到 AzCopy logs 文件夹。 可在以下位置找到此文件夹：

    • Windows： C：\Users\<your username>\.azcopy
    • macOS： ~/.azcopy
    • Linux： ~/.azcopy

网络日志

对于某些问题，需要提供存储资源管理器发出的网络调用的日志。 在 Windows 上，可以使用 Fiddler 获取网络日志。

注意

Fiddler 跟踪可能包含在收集跟踪期间在浏览器中输入或发送的密码。 请务必阅读有关如何清理 Fiddler 跟踪的说明。 不要将 Fiddler 跟踪上传到 GitHub。 系统会告知你可以安全地将 Fiddler 跟踪发送到何处。

第 1 部分：安装和配置 Fiddler

  1. 安装 Fiddler。
  2. 启动 Fiddler。
  3. 转到 “工具>选项”。
  4. 选择“ HTTPS ”选项卡。
  5. 确保已选择 “捕获 CONNECT ”和 “解密 HTTPS 流量 ”。
  6. 选择 “操作”。
  7. 选择“ 信任根证书 ”，然后在下一个对话框中选择“ 是 ”。
  8. 启动存储资源管理器。
  9. 转到“设置”， (应用程序>代理左侧的齿轮符号) >。
  10. 将代理源下拉列表更改为 使用系统代理 (预览) 。
  11. 重启存储资源管理器。
  12. 应开始看到来自 storageexplorer: 某个进程的网络调用显示在 Fiddler 中。

第 2 部分：重现问题

  1. 关闭 Fiddler 以外的所有应用。
  2. 使用左上角的“视图”菜单附近的 X 清除 Fiddler 日志。
  3. 可选/建议：让 Fiddler 设置几分钟。 如果看到与存储资源管理器无关的网络调用出现，请右键单击它们，然后选择“立即>筛选隐藏<进程名称>”。
  4. 启动/重启存储资源管理器。
  5. 重现问题。
  6. 选择“ 文件>保存>所有会话”。 将其保存在你不会忘记的位置。
  7. 关闭 Fiddler 并存储资源管理器。

第 3 部分：清理 Fiddler 跟踪

  1. 双击 Fiddler 跟踪 (.saz 文件) 。
  2. 选择 Ctrl + F。
  3. 在显示的对话框中，确保设置了以下选项：搜索 = 请求和响应以及检查 = 标头和正文。
  4. 搜索收集 Fiddler 跟踪和突出显示的任何条目时使用的任何密码。 右键单击并选择“ 删除>所选会话”。
  5. 如果在收集跟踪时确实在浏览器中输入了密码，但在使用 Ctrl + F 时找不到任何条目，则不想更改密码，或者如果你使用的密码用于其他帐户，请跳过向我们发送 .saz 文件。
  6. 再次使用新名称保存跟踪。
  7. 可选：删除原始跟踪。

后续步骤

如果这些解决方案都不起作用，请使用以下方法之一：

第三方信息免责声明

本文中提到的第三方产品由 Microsoft 以外的其他公司提供。 Microsoft 不对这些产品的性能或可靠性提供任何明示或暗示性担保。

联系我们寻求帮助

如果你有任何疑问或需要帮助，请创建支持请求或联系 Azure 社区支持。 还可以向 Azure 反馈社区提交产品反馈。