排查 Azure 文件同步同步运行状况问题和错误

本文旨在帮助排查和解决在 Azure 文件同步部署中可能遇到的常见同步问题。

同步运行状况

我通过 SMB 或门户在 Azure 文件共享中直接创建了一个文件，该文件同步到同步组中的服务器需要多长时间？

与对服务器终结点所做的更改不同，使用 Azure 门户或 SMB 对 Azure 文件共享所做的更改不会立即检测到并复制。 Azure 文件存储还没有更改通知或日记功能，因此在更改文件时无法自动启动同步会话。 在 Windows Server 上，Azure 文件同步使用 Windows USN 日记可在文件更改时自动启动同步会话。

为了检测对 Azure 文件共享所做的更改，Azure 文件同步有一个称为更改检测作业的计划作业。 更改检测作业枚举文件共享中的每个文件，然后将它与该文件的同步版本进行比较。 当更改检测作业确定文件已更改时，Azure 文件同步会启动同步会话。 更改检测作业每 24 小时启动一次。 由于更改检测作业的工作原理是枚举 Azure 文件共享中的每个文件，因此大命名空间用时会长于较小的命名空间。 对于大命名空间，用时可能超过每 24 小时一次，才能确定哪些文件已更改。

若要立即同步 Azure 文件共享中更改的文件， Invoke-AzStorageSyncChangeDetection 可以使用 PowerShell cmdlet 手动启动对 Azure 文件共享中更改的检测。 此 cmdlet 适用于某些类型的自动化过程在 Azure 文件共享中进行更改或由管理员完成更改（如将文件和目录移动到共享中）的情况。 对于最终用户的更改，建议在 IaaS VM 中安装 Azure 文件同步代理，并让最终用户通过 IaaS VM 访问文件共享。 这样，所有更改都会快速同步到其他代理，而无需使用 Invoke-AzStorageSyncChangeDetection cmdlet。 若要了解详细信息，请参阅 Invoke-AzStorageSyncChangeDetection 文档。

我们正在探讨针对 Azure 文件共享添加类似于针对 Windows Server 上的卷使用的 USN 的更改检测功能。 请在 Azure Community Feedback 上为此功能投票，帮助我们确定将来开发此功能的优先级。

服务器终结点运行状况有多个小时处于挂起状态

如果创建云终结点并使用包含数据的 Azure 文件共享，则可能会出现此问题。 在云与服务器终结点之间同步文件之前，扫描 Azure 文件共享中的更改的云更改枚举作业必须已完成。 完成该作业所需的时间取决于 Azure 文件共享中命名空间的大小。 更改枚举作业完成后，服务器终结点运行状况应会更新。

若要检查云更改枚举作业的状态，请在门户中转到 云终结点 属性，并在 “更改枚举 ”部分提供状态。

如何监视同步运行状况？

Replica Sync session completed.
SyncDirection: Upload,
HResult: 0, 
SyncFileCount: 2, SyncDirectoryCount: 0,
AppliedFileCount: 2, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0,
TransferredFiles: 2, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

Replica Sync session completed.
SyncDirection: Upload,
HResult: -2134364065,
SyncFileCount: 0, SyncDirectoryCount: 0, 
AppliedFileCount: 0, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0, 
TransferredFiles: 0, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

如何监视当前同步会话的进度？

Replica Sync Progress. 
ServerEndpointName: <CI>sename</CI>, SyncGroupName: <CI>sgname</CI>, ReplicaName: <CI>rname</CI>, 
SyncDirection: Upload, CorrelationId: {AB4BA07D-5B5C-461D-AAE6-4ED724762B65}. 
AppliedItemCount: 172473, TotalItemCount: 624196. AppliedBytes: 51473711577, 
TotalBytes: 293363829906. 
AreTotalCountsFinal: true. 
PerItemErrorCount: 1006.

如何知道我的服务器是否已彼此同步？

如何确定是否有特定的文件或文件夹未同步？

如果门户中或服务器上的持久同步错误和PerItemErrorCount计数大于 0，则表示某些项目无法同步。文件和文件夹可以具有阻止它们同步的特征。 这些特征可能是永久性的，需要采取明确的措施才能恢复同步，例如，从文件或文件夹名称中删除不支持的字符。 它们也可能是暂时性的，也就是说，该文件或文件夹可自动恢复同步；例如，包含开放句柄的文件在关闭后可自动恢复同步。 当 Azure 文件同步引擎检测到此类问题时，会生成错误日志，可以分析这些日志以列出当前未正确同步的项。

若要查看无法同步的文件和目录的名称，请运行 FileSyncErrorsReport.ps1 PowerShell 脚本（位于 Azure 文件同步代理的代理安装目录中）或使用 Debug-StorageSyncServer cmdlet。 ItemPath 字段告知相对于根同步目录的文件位置。 请参阅修正步骤的常见每项错误列表。

若要使用 Debug-StorageSyncServer cmdlet 识别服务器上无法同步的文件，请运行以下 PowerShell 命令：

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -FileSyncErrorsReport

同步错误

根据文件/目录同步错误进行故障排除

如果文件或目录因错误而无法同步，则会在 Microsoft-FileSync-Agent/ItemResults 事件日志中记录事件。 本部分介绍每个项目错误的常见错误代码和修正步骤。

ItemResults 事件日志中记录的常见每项同步错误

处理不受支持的字符

Azure 文件同步代理 v17 支持 NTFS 文件系统支持的所有字符，但代理项对无效。

如果门户或 FileSyncErrorsReport.ps1 PowerShell 脚本显示每个项同步错误（错误代码0x8007007b、0x80c80255或0x80070459），请检查服务器上是否安装了 Azure 文件同步代理 v17。 如果已安装代理 v17 并且文件由于字符无效而仍无法同步，请使用 ScanUnsupportedChars 脚本重命名包含不受支持的字符的文件。

常见同步错误

本部分介绍同步会话失败并出现错误时的常见错误代码和修正步骤。

同步会话已取消。

同步会话可能出于各种原因失败，包括服务器正在重启或更新、VSS 快照等等。尽管此错误看起来需要继续跟进，但你可放心地将其忽略，除非它持续了好几个小时。

卷快照同步会话取消了文件同步会话，卷快照同步会话每天运行一次，以同步句柄已打开的文件。

无需采取措施。 Azure 文件同步有一个计划任务（VssSyncScheduledTask），该任务每天在服务器上运行一次，以同步正在使用的文件。 此计划任务启动时，它将取消当前上传同步会话（导致0x80c8029c错误代码），创建 VSS 快照，并使用 VSS 快照启动新的上传同步会话。

无法与服务建立连接。

无法从服务器访问 Azure 文件同步服务时，则会发生此错误。 可以执行以下步骤来排查此错误：

1. 验证防火墙未阻止 Windows 服务 FileSyncSvc.exe 。

2. 验证端口 443 对 Azure 文件同步服务的传出连接开启。 可以使用 Test-NetConnection cmdlet 执行此操作。 可以在Azure 文件同步代理和防火墙设置<azure-file-sync-endpoint>以下占位符的 URL。

   Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
   

3. 确保按预期设置代理配置。 使用 Get-StorageSyncProxyConfiguration cmdlet 可实现此目的。 有关为 Azure 文件同步配置代理配置的详细信息，可在 Azure 文件同步代理和防火墙设置中找到。

   $agentPath = "C:\Program Files\Azure\StorageSyncAgent"
   Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
   Get-StorageSyncProxyConfiguration
   

4. 使用 Test-StorageSyncNetworkConnectivity cmdlet 检查服务终结点的网络连接情况。 若要了解详细信息，请参阅测试服务终结点的网络连接情况。

5. 有关网络连接故障排除的其他帮助，请与网络管理员联系。

服务限制了用户请求。

无需采取措施；服务器会重试。 如果此错误持续了几个小时，请创建支持请求。

由于操作中止，同步失败

不需要执行任何操作。 如果此错误持续了几个小时，请创建支持请求。

操作已取消。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

同步被阻止，直至更改检测完成还原后操作

不需要执行任何操作。 使用 Azure 备份还原某个文件或文件共享（云终结点）时，系统会阻止同步，直至在 Azure 文件共享上完成更改检测。 还原完成后，更改检测将立即运行，持续时间基于文件共享中的文件数。

由于在同步文件夹的还原期间启动了暂停，因此该文件夹的同步被阻止。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

同步失败，原因是同步数据库已卸载。

当备份应用程序创建好 VSS 快照且同步数据库已卸载后，通常会发生此错误。 如果此错误持续了几个小时，请创建支持请求。

同步无法访问云终结点中指定的 Azure 文件共享。

之所以发生此错误，是因为 Azure 文件同步代理无法访问 Azure 文件共享。无法访问的可能原因是 Azure 文件共享或托管它的存储帐户不再存在。 可以执行以下步骤来排查此错误：

1. 验证存储帐户是否存在。
2. 确保 Azure 文件共享存在。
3. 确保 Azure 文件同步有权访问存储帐户。
4. 验证存储帐户上的 SMB 安全设置是否允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。 若要查看存储帐户的 SMB 安全设置，请参阅 SMB 安全设置。
5. 验证存储帐户上的防火墙和虚拟网络设置是否已正确配置（如果已启用）

同步失败，原因是该请求无权执行此操作。

出现此错误的原因是，Azure 文件同步代理无权访问 Azure 文件共享。 可以执行以下步骤来排查此错误：

1. 验证存储帐户是否存在。
2. 确保 Azure 文件共享存在。
3. 验证存储帐户上的防火墙和虚拟网络设置是否已正确配置（如果已启用）
4. 确保 Azure 文件同步有权访问存储帐户。

无法解析所用的存储帐户名。

1. 检查是否可从服务器解析存储 DNS 名称。

   Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 443
   

2. 验证存储帐户是否存在。

3. 验证存储帐户上的防火墙和虚拟网络设置是否已正确配置（如果已启用）

访问存储帐户时出现未知错误。

1. 验证存储帐户是否存在。
2. 验证存储帐户上的防火墙和虚拟网络设置是否已正确配置（如果已启用）

由于存储帐户被锁定，同步失败。

发生此错误的原因是存储帐户具有只读 资源锁。 要解决此问题，请删除存储帐户上的只读资源锁。

由于同步数据库出现问题，同步失败。

如果 Azure 文件同步使用的内部数据库出现问题，则会发生此错误。出现此问题时，请创建支持请求，到时我们将与你取得联系，并帮助解决此问题。

服务器上安装的 Azure 文件同步代理版本不受支持。

如果服务器上安装的 Azure 文件同步代理版本不受支持，则会出现此错误。 若要解决此问题，请升级到受支持的代理版本。

达到了 Azure 文件共享存储限制。

达到 Azure 文件共享存储限制时，同步会话将因为出现上述任一错误而失败。若对 Azure 文件共享应用了配额，或者用量超过了 Azure 文件共享的限制，亦可能会出现这种情况。 有关详细信息，请参阅 Azure 文件共享的当前限制。

1. 导航到存储同步服务中的同步组。

2. 选择同步组中的云终结点。

3. 记下打开的窗格中的 Azure 文件共享名称。 选择文件共享名称以打开存储帐户中的文件共享设置页。

   

4. 选择文件共享以获取 “概述 ”页上的详细信息。

5. 选择 “编辑配额 ”以验证文件共享配额。 除非指定了备用配额，否则配额将与 Azure 文件共享的最大大小匹配。

   

如果文件共享已满（已用容量等于配额），则释放文件共享上的空间。 解决此问题的一种可能方法是，使当前服务器终结点的每个子文件夹在其自己的独立同步组中将自己的服务器终结点放入其自己的服务器终结点。 这样，每个子文件夹就会同步到单个 Azure 文件共享。

找不到 Azure 文件共享。

当 Azure 文件共享不可访问时，将发生此错误。 若要进行故障排除，请进行故障排除：

1. 验证存储帐户是否存在。
2. 确保 Azure 文件共享存在。
3. 验证存储帐户上的 SMB 安全设置是否允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。 若要查看存储帐户的 SMB 安全设置，请参阅 SMB 安全设置。

如果 Azure 文件共享已删除，则需要创建新的文件共享，然后重新创建同步组。

此 Azure 订阅暂停时，同步将会暂停。

当 Azure 订阅暂停时，将发生此错误。 还原 Azure 订阅后，会重新启用同步。 有关详细信息，请参阅为何禁用我的 Azure 订阅？如何重新激活它？。

为存储帐户配置了防火墙或虚拟网络。

如果由于设置了存储帐户防火墙或者存储帐户属于虚拟网络而导致 Azure 文件共享不可访问，则会发生此错误。 验证存储帐户上的防火墙和虚拟网络设置是否已正确配置。 有关详细信息，请参阅配置防火墙和虚拟网络设置。

由于同步数据库出现问题，同步失败。

这些错误通常会自行解决，并且可能在以下情况下发生：

• 同步组中服务器之间的文件更改较多。
• 单个文件和目录中出现大量的错误。

如果此错误持续了几个小时，请创建支持请求，我们将与你取得联系，并帮助解决此问题。

同步数据库遇到了 IO 存储繁忙错误。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

同步数据库遇到了 IO 超时。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

同步数据库遇到了 IO 错误。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

同步失败，因为数据已损坏且不可读。

如果服务器终结点所在的 NTFS 卷上存在文件系统损坏，则可能会出现此错误。 若要解决此错误，请在卷上运行 chkdsk 。

同步失败，因为重分析点缓冲区中存在的标记无效。

当文件在不同配置的服务器之间复制时，会发生此错误。 例如，将文件从启用了文件系统筛选器驱动程序或重复数据删除功能的服务器传输到不存在这些功能的服务器可能会导致无法读取的文件，因为重新分析点无效。 若要解决此错误，请删除受影响的文件或将其重新复制为实际文件，而不是重新分析点。

服务器无法建立安全连接。云服务收到意外的证书。

如果组织使用 TLS 终止代理，或恶意实体正在截获服务器与 Azure 文件同步服务之间的通信，则会发生此错误。 如果确定这是预期行为（因为组织使用 TLS 终止代理），请跳过证书验证并改用注册表覆盖。

1. 创建 SkipVerifyingPinnedRootCertificate 注册表值。

   New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Azure\StorageSync -Name SkipVerifyingPinnedRootCertificate -PropertyType DWORD -Value 1
   

2. 在注册的服务器上重启同步服务。

   Restart-Service -Name FileSyncSvc -Force
   

通过设置此注册表值，Azure 文件同步代理将在服务器和云服务之间传输数据时接受本地受信任的任何 TLS/SSL 证书。

同步失败，因为服务器无法从Azure 文件同步服务解码响应。

如果防火墙、代理或网关阻止访问 PKI URL，或者 PKI 服务器关闭，则通常会发生此错误。

若要解决此问题，请确保服务器可以访问以下 URL：

• https://www.microsoft.com/pki/mscorp/cps
• http://crl.microsoft.com/pki/mscorp/crl/
• http://mscrl.microsoft.com/pki/mscorp/crl/
• http://ocsp.msocsp.com
• http://ocsp.digicert.com/
• http://crl3.digicert.com/

安装Azure 文件同步代理后，PKI URL 用于下载与 Azure 文件同步 服务和 Azure 文件共享通信所需的中间证书。 OCSP URL 用于检查证书的状态。 如果错误持续了几天， 请创建支持请求。

由于身份验证出现问题，同步失败。

此错误的常见原因是服务器时间不正确。 如果服务器在虚拟机中运行，请验证主机上的时间是否正确。

由于证书过期，同步失败。

发生此错误是因为用于身份验证的证书已过期。

若要确认证书是否已过期，请执行以下步骤：

1. 打开“证书 MMC”管理单元，选择 “计算机帐户 ”，然后导航到 “证书”（本地计算机）\“个人”\“证书”。
2. 检查客户端身份验证证书是否过期。

如果客户端身份验证证书已过期，请在服务器上运行以下 PowerShell 命令：

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

由于找不到身份验证证书，同步失败。

发生此错误是因为用于身份验证的证书未找到。

若要解决此问题，请在服务器上运行以下 PowerShell 命令：

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

由于找不到身份验证标识，同步失败。

此错误可能由于以下原因而发生：

• 服务器的托管标识租户 ID 与存储同步服务或存储帐户的租户 ID 不匹配。
• 服务器最近重新注册或其托管标识配置已更改，但更新尚未传播。

服务器终结点所在卷的磁盘空间不足。

由于卷没有足够的磁盘空间或已达到磁盘配额限制，同步会话失败，并出现下列其中一项错误。 此错误的常见原因是服务器终结点外部的文件用尽了卷上的空间。 检查服务器上的可用磁盘空间。 可通过添加更多的服务器终结点、将文件移到其他卷，或增大服务器终结点所在卷的大小，来释放卷上的空间。 若使用文件服务器资源管理器或 NTFS 配额在卷上配置了磁盘配额，会提高配额限制。

如果为服务器终结点启用了云分层，请验证文件是否同步到 Azure 文件共享，以避免磁盘空间不足。

服务尚未准备好与此服务器终结点同步。

发生此错误的原因是，云终结点是在 Azure 文件共享上已存在内容的情况下创建的。 Azure 文件同步必须先扫描 Azure 文件共享中的所有内容，然后才能允许服务器终结点继续进行初始同步。 Azure 文件共享上的更改检测完成后，同步就会发生。 更改检测可能需要超过 24 小时才能完成，并且与 Azure 文件共享上的文件和目录数成正比。 如果配置了云分层，将在同步完成后对文件进行分层。

由于许多单独的文件出现问题，同步失败。

当有许多文件由于存在按项列出的错误而无法同步时，同步会话就会因这些错误而失败。 执行如何确定是否有特定的文件或文件夹未同步？部分所述的步骤，以修复按项列出的错误。 对于同步错误 ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED，请提交一个支持案例。

由于服务器终结点路径出现问题，同步失败。

确保路径存在、位于本地 NTFS 卷上，且不是重新分析点或现有服务器终结点。

同步失败，因为筛选器驱动程序版本与代理版本不兼容

发生此错误的原因是加载的云分层筛选器驱动程序 (StorageSync.sys) 版本与 Storage Sync Agent (FileSyncSvc) 服务不兼容。 如果已升级 Azure 文件同步代理，请重启服务器以完成安装。 如果错误继续发生，请卸载代理，重启服务器并重新安装 Azure 文件同步代理。

服务当前不可用。

此错误的原因是 Azure 文件同步服务不可用。 当 Azure 文件同步服务再次可用时，此错误会自动解决。

由于出现异常，同步失败。

此错误的原因是同步因异常而失败。 如果此错误持续了数小时，请创建支持请求。

由于存储帐户已故障转移到另一区域，同步失败。

发生此错误的原因是存储帐户已故障转移到另一区域。 Azure 文件同步不支持存储帐户故障转移功能。 不得对包含 Azure 文件共享且用作 Azure 文件同步中云终结点的存储帐户执行故障转移。 否则，将会导致同步停止，并且可能还会在有新分层文件的情况下导致意外数据丢失。 若要解决此问题，请将帐户移到主要区域。

由于同步数据库出现暂时性的问题，同步失败。

此错误的原因是同步数据库出现内部问题。 重试同步时，此错误会自行解决。 如果此错误持续很长时间，请创建支持请求，我们将与你联系，帮助你解决此问题。

由于Microsoft Entra 租户更改，同步失败

验证你是否已安装最新的 Azure 文件同步代理版本，为 Microsoft.StorageSync 应用程序提供对存储帐户的访问权限（请参阅确保 Azure 文件同步有权访问存储帐户）。

由于未配置防火墙和虚拟网络例外，同步失败

如果在存储帐户上启用防火墙和虚拟网络设置，但未勾选“允许受信任的 Microsoft 服务访问此存储帐户”例外，则会发生此错误。 若要解决此问题，请执行部署指南的配置防火墙和虚拟网络设置部分记录的步骤。

由于存储帐户上的安全设置或服务器上的 NTFS 权限，同步失败，访问被拒绝。

如果Azure 文件同步由于安全设置或 NT AUTHORITY\SYSTEM 帐户无权访问服务器终结点所在卷上的系统卷信息文件夹，则可能会出现此错误。 如果单个文件同步失败并显示 ERROR_ACCESS_DENIED 错误，请执行针对每个文件/目录同步错误的故障排除部分中所述的步骤。

1. 验证存储帐户上的 SMB 安全设置是否允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。 若要查看存储帐户的 SMB 安全设置，请参阅 SMB 安全设置。

2. 验证存储帐户上的防火墙和虚拟网络设置是否已正确配置（如果已启用）

3. 执行以下步骤，验证 NT AUTHORITY\SYSTEM 帐户是否有权访问服务器终结点所在卷上的 系统卷信息 文件夹：

   1. 下载 Psexec 工具。

   2. 从提升的命令提示符运行以下命令，以使用系统帐户启动命令提示符： PsExec.exe -i -s -d cmd

   3. 在系统帐户下运行的命令提示符中，运行以下命令以确认 NT AUTHORITY\SYSTEM 帐户无权访问系统卷信息文件夹： cacls "drive letter:\system volume information" /T /C

   4. 如果 NT AUTHORITY\SYSTEM 帐户无权访问系统卷信息文件夹，请运行以下命令： cacls "drive letter:\system volume information" /T /E /G "NT AUTHORITY\SYSTEM:F"

      如果步骤 d 失败并拒绝访问，请运行以下命令获取系统卷信息文件夹的所有权，然后重复步骤 d：

      takeown /A /R /F "drive letter:\System Volume Information"

由于已删除并重新创建 Azure 文件共享，同步失败。

发生此错误的原因是，Azure 文件同步不支持在同一同步组中删除 Azure 文件共享并重新创建它。

若要解决此问题，请执行以下步骤，以便删除同步组并重新创建它：

1. 删除同步组中的所有服务器终结点。
2. 删除云终结点。
3. 删除同步组。
4. 如果在服务器终结点上启用了云分层，则通过执行“分层文件”部分中所述的步骤删除服务器上的孤立分层文件。
5. 重新创建同步组。

同步检测到副本已还原到较旧状态

不需要执行任何操作。 之所以发生此错误，是因为同步检测到副本已还原到较旧的状态。 现在，同步将进入协调模式；在此模式下，将通过合并 Azure 文件共享的内容和服务器终结点上的数据，重新创建同步关系。 触发对帐模式时，该过程可能非常耗时，具体取决于命名空间大小。 在完成协调前，不会进行常规同步，并且 Azure 文件共享和服务器终结点之间的不同文件（上次修改时间或大小）将导致文件冲突。

同步失败，因为服务器终结点的路径已更改

发生此错误是因为服务器终结点被配置的路径现在位于一个与最初配置时不同的卷上。 出现此问题时，请创建支持请求，我们将与你联系，帮助你解决该问题。

由于重定向了 HTTP 请求，同步失败

发生此错误的原因是 Azure 文件同步不支持 HTTP 重定向（3xx 状态代码）。 要解决此问题，请在代理服务器或网络设备上禁用 HTTP 重定向。

同步会话超时错误。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

操作超时。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

超时错误。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

由于在服务器上找不到服务器终结点路径，同步失败。

如果已重命名或已删除用作服务器终结点路径的目录，则会发生此错误。 如果已重命名该目录，请将目录重命名回原始名称，并重启存储同步代理服务 (FileSyncSvc)。

如果已删除该目录，请执行以下步骤，删除现有服务器终结点，并使用新路径创建一个新的服务器终结点：

1. 按照删除服务器终结点中所述的步骤，在同步组中删除服务器终结点。
2. 按照添加服务器终结点中所述的步骤，在同步组中创建一个新的服务器终结点。

由于服务器路径为空，服务器终结点预配失败。

如果满足以下条件，服务器终结点预配会失败并出现此错误代码：

• 此服务器终结点预配了初始同步模式： 服务器权威
• 本地服务器路径为空或不包含识别为能同步的项。

此预配错误可防止你删除 Azure 文件共享中可能提供的所有内容。 服务器授权上传是一种特殊模式，用于利用服务器位置的更新来了解已设置种子的云位置。 查看此 迁移指南 ，了解已生成此模式的方案。

1. 按照删除服务器终结点中所述的步骤，在同步组中删除服务器终结点。
2. 按照添加服务器终结点中所述的步骤，在同步组中创建一个新的服务器终结点。

拥有该存储帐户的订阅已禁用。

请检查并确保存储帐户所在的订阅已启用。

指定的网络名称不再可用。

使用 Test-StorageSyncNetworkConnectivity cmdlet 检查服务终结点的网络连接情况。 有关详细信息，请参阅 测试到服务终结点的网络连接。

同步会话错误。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

同步会话错误。

如果此错误持续了一天以上，请创建支持请求。

发生了内部错误。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

发生了内部错误。

如果此错误持续了一天以上，请创建支持请求。

发生了内部错误。

请升级到最新的文件同步代理版本。 如果在升级代理后错误仍然存在，请创建支持请求。

由于身份验证失败，操作失败。

如果此错误持续了一天以上，请创建支持请求。

指定的 Azure 帐户已禁用。

请检查并确保存储帐户所在的订阅已启用。

基于存储帐户密钥的身份验证被阻止。

在存储帐户上启用“允许存储帐户密钥访问”。 了解详细信息。

同步需要更新服务器上的数据库。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

卷处于脱机状态。其已被删除、未就绪或未连接。

请验证服务器终结点所在的卷是否已附加到服务器。

专用终结点配置访问被阻止。

检查专用终结点配置并允许访问文件同步服务。 了解详细信息。

同步需要先协调服务器和 Azure 文件共享数据，然后才能上传文件。

无需采取措施。 此错误应该会自动解决。 如果此错误持续数天，请创建支持请求。

不允许同一用户使用多个用户名与服务器或共享资源建立多个连接。

断开之前与服务器或共享资源的所有连接，然后重试。

服务器的 SSL 证书无效或已过期。

在服务器上运行以下 PowerShell 命令以重置证书：

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

常见故障排除步骤

验证存储帐户是否存在。

# Variables for you to populate based on your configuration
$region = "<Az_Region>"
$resourceGroup = "<RG_Name>"
$syncService = "<storage-sync-service>"
$syncGroup = "<sync-group>"

# Log into the Azure account
Connect-AzAccount

# Check to ensure Azure File Sync is available in the selected Azure
# region.
$regions = [System.String[]]@()
Get-AzLocation | ForEach-Object { 
    if ($_.Providers -contains "Microsoft.StorageSync") { 
        $regions += $_.Location 
    } 
}

if ($regions -notcontains $region) {
    throw [System.Exception]::new("Azure File Sync is either not available in the " + `
        " selected Azure Region or the region is mistyped.")
}

# Check to ensure resource group exists
$resourceGroups = [System.String[]]@()
Get-AzResourceGroup | ForEach-Object { 
    $resourceGroups += $_.ResourceGroupName 
}

if ($resourceGroups -notcontains $resourceGroup) {
    throw [System.Exception]::new("The provided resource group $resourceGroup does not exist.")
}

# Check to make sure the provided Storage Sync Service
# exists.
$syncServices = [System.String[]]@()

Get-AzStorageSyncService -ResourceGroupName $resourceGroup | ForEach-Object {
    $syncServices += $_.StorageSyncServiceName
}

if ($syncServices -notcontains $syncService) {
    throw [System.Exception]::new("The provided Storage Sync Service $syncService does not exist.")
}

# Check to make sure the provided Sync Group exists
$syncGroups = [System.String[]]@()

Get-AzStorageSyncGroup -ResourceGroupName $resourceGroup -StorageSyncServiceName $syncService | ForEach-Object {
    $syncGroups += $_.SyncGroupName
}

if ($syncGroups -notcontains $syncGroup) {
    throw [System.Exception]::new("The provided sync group $syncGroup does not exist.")
}

# Get reference to cloud endpoint
$cloudEndpoint = Get-AzStorageSyncCloudEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $syncService `
    -SyncGroupName $syncGroup

# Get reference to storage account
$storageAccount = Get-AzStorageAccount | Where-Object { 
    $_.Id -eq $cloudEndpoint.StorageAccountResourceId
}

if ($storageAccount -eq $null) {
    throw [System.Exception]::new("The storage account referenced in the cloud endpoint does not exist.")
}

确保 Azure 文件共享存在。

$fileShare = Get-AzStorageShare -Context $storageAccount.Context | Where-Object {
    $_.Name -eq $cloudEndpoint.AzureFileShareName -and
    $_.IsSnapshot -eq $false
}

if ($fileShare -eq $null) {
    throw [System.Exception]::new("The Azure file share referenced by the cloud endpoint does not exist")
}

确保 Azure 文件同步有权访问存储帐户。

$role = Get-AzRoleAssignment -Scope $storageAccount.Id | Where-Object { $_.DisplayName -eq "Microsoft.StorageSync" }

if ($role -eq $null) {
    throw [System.Exception]::new("The storage account does not have the Azure File Sync " + `
                "service principal authorized to access the data within the " + ` 
                "referenced Azure file share.")
}

另请参阅

• 排查 Azure 文件同步组管理问题
• 排查 Azure 文件同步代理安装和服务器注册问题
• 排查 Azure 文件同步云分层问题
• 监视 Azure 文件同步
• 排查 Azure 文件存储问题

联系我们寻求帮助

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