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

项目
11/20/2024

本文旨在帮助排查和解决在 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 文件共享中命名空间的大小。更改枚举作业完成后，服务器终结点运行状况应会更新。

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

要在门户中查看服务器终结点的运行状况，请导航到存储同步服务的同步组部分，然后选择同步组。

正常状态和持久同步错误计数为 0 表示同步按预期工作。如果持久同步错误计数大于 0，请参阅如何实现查看是否存在未同步的特定文件或文件夹，以排查文件无法同步的原因。如果服务器终结点的运行状况状态为“正常”，请按照下表中的指南进行操作。

运行状况状态	说明	补救
Healthy	同步会话成功完成或正在进行的同步会话正在进行（文件已应用）。	空值
挂起的	创建服务器终结点后，需要挂起状态。将服务器终结点的同步遥测数据发送到服务后，运行状况状态将更新。	如果运行状况状态未更改数小时，请参阅服务器终结点运行状况处于挂起状态数小时。
错误	同步会话失败并出现错误。	若要解决此问题，请在门户中选择 “错误 ”状态以获取错误代码和修正步骤。如果门户中未列出修正步骤或未解决问题，请搜索本文档中的错误代码以获取更多指导。
无活动	过去两小时内，存储同步服务尚未从此服务器终结点接收同步遥测数据。	若要解决此问题，请按照Azure 文件同步同步组管理故障排除中的步骤进行操作。
低磁盘模式	服务器终结点所在卷的磁盘空间不足。	若要解决此问题，请在卷上释放磁盘空间。若要详细了解磁盘空间不足模式，请参阅云分层概述。
预配已取消	服务器终结点创建失败。同步在此服务器终结点上不起作用。	若要解决此问题，请参阅服务器终结点创建和删除错误。

注意

服务器终结点状态（运行状况和活动）每隔 15 分钟刷新一次，并基于从服务器发送到服务的遥测事件。

查看服务器上的遥测日志中的最新 9102 事件（在事件查看器中，转到应用程序和服务日志\Microsoft\FileSync\Agent\Telemetry）。完成同步会话后，将记录此事件。 SyncDirection 会告知你此会话是上传还是下载。如果 HResult 为 0，则同步会话已成功。如果 HResult 不为 0，则表示同步期间发生错误；请参阅下文，了解常见错误的列表。如果 PerItemErrorCount 大于 0，则某些文件或文件夹未正确同步。有可能会出现 HResult 为 0，但 PerItemErrorCount 大于 0 的情况。

下面是成功上传的示例。为简洁起见，只列出了每个 9102 事件中包含的某些值。

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.

有时，同步会话虽然总体失败或者出现非零值的 PerItemErrorCount，但仍能继续进行，并且某些文件能够成功同步。可以通过查看“已应用”字段（AppliedFileCount、AppliedDirCount和AppliedTombstoneCountAppliedSizeBytes）来确定进度。这些字段描述了会话成功的程度。如果在某一行中看到多个同步会话失败，但 Applied 计数增加，则应该提供一定的同步时间以便重试，然后再开具支持票证。

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

门户
服务器

在同步组中，转到服务器终结点属性并查看 “同步状态 ”部分，查看当前同步会话中上传或下载的文件计数。此状态将延迟约 15 分钟。如果同步会话足够小，可在此时间段内完成，则可能不会在门户中报告此会话。

注意

如果估计完成为空，则表示同步尚未完成对同步会话中的文件数进行计数。

查看服务器上的遥测日志中的最新 9302 事件（在事件查看器中，转到应用程序和服务日志\Microsoft\FileSync\Agent\Telemetry）。此事件指示当前同步会话的状态。 TotalItemCount 表示要同步的文件数， AppliedItemCount 表示到目前为止已同步的文件数，并 PerItemErrorCount 表示未能同步的文件数（有关如何处理此操作，请参阅以下内容）。

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.

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

门户
服务器

对于给定同步组中的每个服务器，请确保：

“上传到云”和“下载到服务器”的时间戳是最新的。
上传和下载会话的状态为绿色。
服务器终结点属性中的“同步状态”部分显示极少数或没有要同步的文件。
服务器 终结点属性中的持久同步错误 和 暂时同步错误 字段的计数为 0。

查看由每个服务器的遥测事件日志中的 9102 事件标记的已完成同步会话（在事件查看器中，转到 Applications and Services Logs\Microsoft\FileSync\Agent\Telemetry）。

在任何给定的服务器上，需要确保最近的上传和下载会话已成功完成。

为此，请检查HResultPerItemErrorCount上传和下载是否为 0（SyncDirection该字段指示给定会话是上传或下载会话）。请注意，如果未看到最近完成的同步会话，则同步会话当前可能正在进行中，如果刚添加或修改大量数据，则预期会出现此情况。
如果服务器在云中完全处于最新状态，并且不包含要朝任一方向同步的更改，则你会看到空的同步会话。这些状态由上传和下载事件指示。在这些事件中，Sync* 字段（SyncFileCount、SyncDirCount、SyncTombstoneCount 和 SyncSizeBytes）为 0，表示没有要同步的内容。请注意，在数据变动率较高的服务器上，可能不会出现这些空的同步会话，因为始终有新的内容需要同步。如果没有任何同步活动，同步会话应每隔 30 分钟发生一次。
如果所有服务器在云中处于最新状态，则意味着这些服务器的最近上传和下载会话是空的同步会话，此时可以合理地确定系统在整体上是同步的。

如果直接在 Azure 文件共享中进行了更改，则在更改枚举运行之前，Azure 文件同步不会检测到这些更改，每次 24 小时就会发生一次。有可能服务器在云中处于最新状态，但事实上它缺少 Azure 文件共享中所做的最新更改。

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

如果门户中或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 事件日志中记录一个事件。本部分介绍每个项目错误的常见错误代码和修正步骤。

注意

如果文件或目录无法同步，可能需要长达 30 分钟的时间才能Azure 文件同步重试同步该项目。如果未在服务器终结点位置内检测到任何更改，Azure 文件同步每隔 30 分钟启动一个同步会话。若要强制同步会话，请重启存储同步代理（FileSyncSvc）服务，或者更改服务器终结点位置中的文件或目录。

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

HRESULT	HRESULT（十进制）	错误字符串	问题	补救
0x80070043	-2147942467	ERROR_BAD_NET_NAME	服务器上的分层文件不可访问。如果在删除服务器终结点之前未撤回该分层文件，则会出现此问题。	若要解决此问题，请参阅在删除服务器终结点后无法访问服务器上的分层文件。
0x80c80207	-2134375929	ECS_E_SYNC_CONSTRAINT_CONFLICT	由于尚未同步某个相关的文件夹，无法同步文件或目录更改。在同步相关的更改后，此项将会同步。	暂时性的错误。如果此错误持续数天，请创建支持请求。
0x80C8028A	-2134375798	ECS_E_SYNC_CONSTRAINT_CONFLICT_ON_FAILED_DEPENDEE	由于尚未同步某个相关的文件夹，无法同步文件或目录更改。在同步相关的更改后，此项将会同步。	暂时性的错误。如果错误仍然存在，请使用 FileSyncErrorsReport.ps1 PowerShell 脚本来确定相关文件夹尚未同步的原因。
0x80c80284	-2134375804	ECS_E_SYNC_CONSTRAINT_CONFLICT_SESSION_FAILED	无法同步文件或目录更改，因为尚未同步某个相关的文件夹且同步会话失败。在同步相关的更改后，此项将会同步。	无需采取措施。如果错误仍然存在，请调查同步会话失败。
0x8007007b	-2147024773	ERROR_INVALID_NAME	文件或目录名称无效。	重命名有问题的文件或目录。有关详细信息，请参阅处理不支持的字符。
0x80070459	-2147023783	ERROR_NO_UNICODE_TRANSLATION	文件或目录名称具有不支持的代理项对字符。	重命名有问题的文件或目录。有关详细信息，请参阅处理不支持的字符。
0x80c80255	-2134375851	ECS_E_XSMB_REST_INCOMPATIBILITY	文件或目录名称无效。	重命名有问题的文件或目录。有关详细信息，请参阅处理不支持的字符。
0x80c80018	-2134376424	ECS_E_SYNC_FILE_IN_USE	文件在使用中，因此无法同步。不再使用该文件时，会将其同步。	无需采取措施。 Azure 文件同步每天在服务器上创建临时 VSS 快照一次，以同步包含开放句柄的文件。
0x80c8031d	-2134375651	ECS_E_CONCURRENCY_CHECK_FAILED	文件已更改，但同步尚未检测到此更改。检测到此更改后，将恢复同步。	无需采取措施。
0x80070002	-2147024894	ERROR_FILE_NOT_FOUND	文件已删除，而同步不了解此更改。	无需采取措施。一旦更改检测操作检测到文件已删除，同步会停止记录此错误。
0x80070003	-2147024893	ERROR_PATH_NOT_FOUND	无法同步文件删除或目录删除，因为该项已在目标中删除，而同步不知道此项更改。	无需采取措施。在目标上运行更改检测且同步检测到该项已删除后，同步会停止记录此错误。
0x80c80205	-2134375931	ECS_E_SYNC_ITEM_SKIP	文件或目录已跳过，但会在下一个同步会话期间进行同步。如果在下载此项时报告此错误，则文件或目录名称很可能无效。	如果在上传文件时报告此错误，则无需采取任何措施。如果在下载文件时报告此错误，请重命名相关文件或目录。有关详细信息，请参阅处理不支持的字符。
0x800700B7	-2147024713	ERROR_ALREADY_EXISTS	无法同步创建文件或目录，因为该项已在目标中存在，而同步不知道此项更改。	无需采取措施。在目标上运行更改检测且同步了解此新项目时，同步会停止记录此错误。
0x80c8603e	-2134351810	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED	无法同步该文件，因为已达到 Azure 文件共享限制。	要解决此问题，请参阅疑难解答指南中的达到 Azure 文件共享存储限制部分。
0x80c83008	-2134364152	ECS_E_CANNOT_CREATE_AZURE_STAGED_FILE	无法同步该文件，因为已达到 Azure 文件共享限制。	要解决此问题，请参阅疑难解答指南中的达到 Azure 文件共享存储限制部分。
0x80c8027C	-2134375812	ECS_E_ACCESS_DENIED_EFS	文件是使用不受支持的解决方案（如 NTFS EFS）加密的。	解密该文件并使用支持的加密解决方案。有关支持解决方案的列表，请参阅计划指南的加密部分。
0x80c80283	-2160591491	ECS_E_ACCESS_DENIED_DFSRRO	文件位于一个 DFS-R 只读复制文件夹中。	文件位于一个 DFS-R 只读复制文件夹中。 Azure 文件同步不支持 DFS-R 只读复制文件夹中的服务器终结点。请参阅规划指南以获取详细信息。
0x80070005	-2147024891	ERROR_ACCESS_DENIED	文件处于“删除挂起”状态。	无需采取措施。一旦关闭所有打开的文件句柄，就会删除文件。
0x80c86044	-2134351804	ECS_E_AZURE_AUTHORIZATION_FAILED	文件不能同步，原因是存储帐户上的防火墙和虚拟网络设置已启用，服务器不能访问存储帐户。	按照部署指南中的配置防火墙和虚拟网络设置部分中所述的步骤添加服务器 IP 地址或虚拟网络。
0x8000ffff	-2147418113	E_UNEXPECTED	由于出现意外错误，文件无法同步。	如果此错误持续数天，请提交一个支持案例。
0x80070020	-2147024864	ERROR_SHARING_VIOLATION	文件在使用中，因此无法同步。不再使用该文件时，会将其同步。	无需采取措施。
0x80c80017	-2134376425	ECS_E_SYNC_OPLOCK_BROKEN	同步期间更改了文件，因此需要重新同步。	无需采取措施。
0x80070017	-2147024873	ERROR_CRC	由于出现 CRC 错误，文件无法同步。如果在删除服务器终结点之前未撤回该分层文件，或者文件已损坏，则会出现此错误。	若要解决此问题，请参阅删除服务器终结点后无法在服务器上访问分层文件以删除孤立的分层文件。如果在删除孤立的分层文件后仍然出现错误，请在卷上运行 chkdsk。
0x800703ee	-2147023890	ERROR_FILE_INVALID	无法同步文件，因为它不再有效。如果文件分层并孤立，则通常会发生此错误。	如果文件已分层，则删除服务器终结点以删除孤立的分层文件后，在服务器上无法访问分层文件。
0x80070570	-2147023504	ERROR_FILE_CORRUPT	该文件或目录已损坏且无法读取。	在卷上运行 chkdsk 。
0x80c80200	-2134375936	ECS_E_SYNC_CONFLICT_NAME_EXISTS	由于已达到冲突文件最大数量，文件无法同步。 Azure 文件同步支持每文件 100 个冲突文件。若要了解有关文件冲突的详细信息，请参阅 Azure 文件同步常见问题解答。	若要解决此问题，请减少冲突文件数。冲突文件数小于 100 后，文件将同步。
0x80c8027d	-2134375811	ECS_E_DIRECTORY_RENAME_FAILED	无法同步重命名的目录，因为目录中的文件或文件夹具有打开的句柄。	无需采取措施。目录中所有打开的文件句柄遭关闭后，目录的重命名将会同步。
0x800700de	-2147024674	ERROR_BAD_FILE_TYPE	无法访问服务器上的分层文件，因为它引用的文件版本不再存在于 Azure 文件共享中。	如果分层文件从 Windows Server 的备份还原，则可能出现此问题。若要解决此问题，请在 Azure 文件共享中从快照中还原文件。
0x80C80065	-2134376347	ECS_E_DATA_TRANSFER_BLOCKED	文件已被识别为在同步期间产生永久性错误。因此，在达到重试间隔之前，会阻止其同步。稍后将重试该文件。	无需采取措施。将在 24 小时之后重试该文件。如果此错误持续数天，请创建支持请求。
0x80C80203	-2134375933	ECS_E_SYNC_INVALID_STAGED_FILE	文件传输错误。服务稍后将会重试。	无需采取措施。此错误应该会自动解决。如果此错误持续数天，请创建支持请求。
0x80c8027f	-2134375809	ECS_E_SYNC_CONSTRAINT_CONFLICT_CYCLIC_DEPENDENCY	同步会话超时错误。	无需采取措施。此错误应该会自动解决。如果此错误持续数天，请创建支持请求。
0x80070035	-2147024843	ERROR_BAD_NETPATH	找不到网络路径。	无需采取措施。此错误应该会自动解决。如果此错误持续数天，请创建支持请求。
0x80071779	-2147018887	ERROR_FILE_READ_ONLY	指定的文件为只读。	如果此错误持续了一天以上，请创建支持请求。
0x80070006	-2147024890	ERROR_INVALID_HANDLE	发生内部错误。	如果此错误持续了一天以上，请创建支持请求。
0x8007012f	-2147024593	ERROR_DELETE_PENDING	无法打开该文件，因为正在将其删除。	无需采取措施。此错误应该会自动解决。如果此错误持续数天，请创建支持请求。
0x80041007	-2147217401	SYNC_E_ITEM_MUST_EXIST	发生内部错误。	如果此错误持续了一天以上，请创建支持请求。
0X80C80293	-2134375789	ECS_E_SYNC_INITIAL_SCAN_COMPLETED	同步会话失败，因为初始枚举已完成。下一个会话将涵盖完整的命名空间。	无需采取措施。此错误应该会自动解决。如果此错误持续数天，请创建支持请求。
0X80C80342	-2134375614	ECS_E_SYNC_CUSTOM_METADATA_VERSION_NOT_SUPPORTED	同步数据库具有版本高于受支持的版本的自定义元数据。	请将文件同步代理升级到最新版本。如果在升级代理后错误仍然存在，请创建支持请求。

处理不受支持的字符

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

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

常见同步错误

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

同步会话已取消。

错误	代码
HRESULT	0x800704c7
HRESULT（十进制）	-2147023673
错误字符串	ERROR_CANCELLED
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c8029c
HRESULT（十进制）	-2134375780
错误字符串	ECS_E_SYNC_CANCELLED_BY_VSS
所需的补救措施	否

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

无法与服务建立连接。

错误	代码
HRESULT	0x80072ee7
HRESULT（十进制）	-2147012889
错误字符串	WININET_E_NAME_NOT_RESOLVED
所需的补救措施	是

错误	代码
HRESULT	0x80c83081
HRESULT（十进制）	-2134364031
错误字符串	ECS_E_HTTP_CLIENT_CONNECTION_ERROR
所需的补救措施	是

错误	代码
HRESULT	0x80c8309a
HRESULT（十进制）	-2134364006
错误字符串	ECS_E_AZURE_STORAGE_REMOTE_NAME_NOT_RESOLVED
所需的补救措施	是

错误	代码
HRESULT	0xc00000c4
HRESULT（十进制）	-1073741628
错误字符串	UNEXPECTED_NETWORK_ERROR
所需的补救措施	是

错误	代码
HRESULT	0x80072ee2
HRESULT（十进制）	-2147012894
错误字符串	WININET_E_TIMEOUT
所需的补救措施	是

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

验证防火墙未阻止 Windows 服务 FileSyncSvc.exe 。
验证端口 443 对 Azure 文件同步服务的传出连接开启。可以使用 Test-NetConnection cmdlet 执行此操作。可以在Azure 文件同步代理和防火墙设置文档中找到以下占位符的 <azure-file-sync-endpoint> URL。
```
Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
```
确保按预期设置代理配置。使用 Get-StorageSyncProxyConfiguration cmdlet 可实现此目的。有关为 Azure 文件同步配置代理配置的详细信息，可在 Azure 文件同步代理和防火墙设置中找到。
```
$agentPath = "C:\Program Files\Azure\StorageSyncAgent"
Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncProxyConfiguration
```
使用 Test-StorageSyncNetworkConnectivity cmdlet 检查服务终结点的网络连接情况。若要了解详细信息，请参阅测试服务终结点的网络连接情况。
有关网络连接故障排除的其他帮助，请与网络管理员联系。

注意

连接到 Azure 文件同步服务的网络连接恢复后，同步可能不会立即恢复。默认情况下，若在服务器终结点位置未检测到任何更改，Azure 文件同步将每 30 分钟启动一次同步会话。若要强制执行同步会话，请重启存储同步代理 (FileSyncSvc) 服务，或对服务器终结点位置内的文件或目录进行更改。

服务限制了用户请求。

错误	代码
HRESULT	0x80c8004c
HRESULT（十进制）	-2134376372
错误字符串	ECS_E_USER_REQUEST_THROTTLED
所需的补救措施	否

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

由于操作中止，同步失败

错误	代码
HRESULT	0x80c83000
HRESULT（十进制）	-2134364160
错误字符串	ECS_E_OPERATION_ABORTED
所需的补救措施	否

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

操作已取消。

错误	代码
HRESULT	0x80c8308d
HRESULT（十进制）	-2134364019
错误字符串	ECS_E_REQUEST_CANCELLED_EXTERNALLY
所需的补救措施	否

错误	代码
HRESULT	0x8013153b
HRESULT（十进制）	-2146233029
错误字符串	COR_E_OPERATIONCANCELED
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c83075
HRESULT（十进制）	-2134364043
错误字符串	ECS_E_SYNC_BLOCKED_ON_CHANGE_DETECTION_POST_RESTORE
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c83058
HRESULT（十进制）	-2134364072
错误字符串	ECS_E_SYNC_BLOCKED_ON_RESTORE
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80041295
HRESULT（十进制）	-2147216747
错误字符串	SYNC_E_METADATA_INVALID_OPERATION
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c8305f
HRESULT（十进制）	-2134364065
错误字符串	ECS_E_EXTERNAL_STORAGE_ACCOUNT_AUTHORIZATION_FAILED
所需的补救措施	是

错误	代码
HRESULT	0x80c86053
HRESULT（十进制）	-2134351789
错误字符串	ECS_E_AZURE_FILE_SHARE_NOT_ACCESSIBLE
所需的补救措施	是

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

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

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

错误	代码
HRESULT	0x80c86044
HRESULT（十进制）	-2134351804
错误字符串	ECS_E_AZURE_AUTHORIZATION_FAILED
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80C83060
HRESULT（十进制）	-2134364064
错误字符串	ECS_E_STORAGE_ACCOUNT_NAME_UNRESOLVED
所需的补救措施	是

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

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

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

注意

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

错误	代码
HRESULT	0x80c8308a
HRESULT（十进制）	-2134364022
错误字符串	ECS_E_STORAGE_ACCOUNT_UNKNOWN_ERROR
所需的补救措施	是

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

错误	代码
HRESULT	0x80c83092
HRESULT（十进制）	-2134364014
错误字符串	ECS_E_STORAGE_ACCOUNT_LOCKED
所需的补救措施	是

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

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

错误	代码
HRESULT	0x8e5e044e
HRESULT（十进制）	-1906441138
错误字符串	JET_errWriteConflict
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80C8306B
HRESULT（十进制）	-2134364053
错误字符串	ECS_E_AGENT_VERSION_BLOCKED
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c8603e
HRESULT（十进制）	-2134351810
错误字符串	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED
所需的补救措施	是

错误	代码
HRESULT	0x80c80249
HRESULT（十进制）	-2134375863
错误字符串	ECS_E_NOT_ENOUGH_REMOTE_STORAGE
所需的补救措施	是

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

导航到存储同步服务中的同步组。
选择同步组中的云终结点。
记下打开的窗格中的 Azure 文件共享名称。选择文件共享名称以打开存储帐户中的文件共享设置页。
选择文件共享以获取“ 概述 ”页上的详细信息。
选择“编辑配额”以验证文件共享配额。除非指定了备用配额，否则配额将与 Azure 文件共享的最大大小匹配。

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

找不到 Azure 文件共享。

错误	代码
HRESULT	0x80c86030
HRESULT（十进制）	-2134351824
错误字符串	ECS_E_AZURE_FILE_SHARE_NOT_FOUND
所需的补救措施	是

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

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

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

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

错误	代码
HRESULT	0x80C83076
HRESULT（十进制）	-2134364042
错误字符串	ECS_E_SYNC_BLOCKED_ON_SUSPENDED_SUBSCRIPTION
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c8033e
HRESULT（十进制）	-2134375618
错误字符串	ECS_E_SERVER_BLOCKED_BY_NETWORK_ACL
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c80219
HRESULT（十进制）	-2134375911
错误字符串	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT
所需的补救措施	否

错误	代码
HRESULT	0x80c83044
HRESULT（十进制）	-2134364092
错误字符串	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT_SERVICEUNAVAILABLE
所需的补救措施	否

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

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

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

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

错误	代码
HRESULT	0x80c8021f
HRESULT（十进制）	-2134375905
错误字符串	ECS_E_SYNC_METADATA_IO_BUSY
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c8021e
HRESULT（十进制）	-2134375906
错误字符串	ECS_E_SYNC_METADATA_IO_TIMEOUT
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c80220
HRESULT（十进制）	-2134375904
错误字符串	ECS_E_SYNC_METADATA_IO_ERROR
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80071128
HRESULT（十进制）	-2147020504
错误字符串	ERROR_INVALID_REPARSE_DATA
所需的补救措施	是

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

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

错误	代码
HRESULT	0x800b0109
HRESULT（十进制）	-2146762487
错误字符串	CERT_E_UNTRUSTEDROOT
所需的补救措施	是

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

创建 SkipVerifyingPinnedRootCertificate 注册表值。

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

在注册的服务器上重启同步服务。
```
Restart-Service -Name FileSyncSvc -Force
```

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

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

错误	代码
HRESULT	0x80072f8f
HRESULT（十进制）	-2147012721
错误字符串	WININET_E_DECODING_FAILED
所需的补救措施	是

如果防火墙、代理或网关阻止访问 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 用于检查证书的状态。如果错误持续了几天，请创建支持请求。

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

错误	代码
HRESULT	0x80c80300
HRESULT（十进制）	-2134375680
错误字符串	ECS_E_SERVER_CREDENTIAL_NEEDED
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c83078
HRESULT（十进制）	-2134364040
错误字符串	ECS_E_AUTH_SRV_CERT_EXPIRED
所需的补救措施	是

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

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

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

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

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

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

错误	代码
HRESULT	0x80c80228
HRESULT（十进制）	-2134375896
错误字符串	ECS_E_AUTH_SRV_CERT_NOT_FOUND
所需的补救措施	是

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

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

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

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

错误	代码
HRESULT	0x80c83079
HRESULT（十进制）	-2134364039
错误字符串	ECS_E_AUTH_IDENTITY_NOT_FOUND
所需的补救措施	是

发生此错误的原因是服务器终结点删除失败，并且终结点现在处于部分删除状态。若要解决此问题，请重新尝试删除服务器终结点。

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

错误	代码
HRESULT	0x8e5e0211
HRESULT（十进制）	-1906441711
错误字符串	JET_errLogDiskFull
所需的补救措施	是

错误	代码
HRESULT	0x80c8031a
HRESULT（十进制）	-2134375654
错误字符串	ECS_E_NOT_ENOUGH_LOCAL_STORAGE
所需的补救措施	是

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

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

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

错误	代码
HRESULT	0x80c8300f
HRESULT（十进制）	-2134364145
错误字符串	ECS_E_REPLICA_NOT_READY
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c8023b
HRESULT（十进制）	-2134375877
错误字符串	ECS_E_SYNC_METADATA_KNOWLEDGE_SOFT_LIMIT_REACHED
所需的补救措施	是

错误	代码
HRESULT	0x80c8021c
HRESULT（十进制）	-2134375908
错误字符串	ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED
所需的补救措施	是

错误	代码
HRESULT	0x80c80253
HRESULT（十进制）	-2134375853
错误字符串	ECS_E_TOO_MANY_PER_ITEM_ERRORS
所需的补救措施	是

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

注意

Azure 文件同步每天在服务器上创建临时 VSS 快照一次，以同步包含开放句柄的文件。

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

错误	代码
HRESULT	0x80c80019
HRESULT（十进制）	-2134376423
错误字符串	ECS_E_SYNC_INVALID_PATH
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80C80277
HRESULT（十进制）	-2134375817
错误字符串	ECS_E_INCOMPATIBLE_FILTER_VERSION
所需的补救措施	是

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

服务当前不可用。

错误	代码
HRESULT	0x80c8004b
HRESULT（十进制）	-2134376373
错误字符串	ECS_E_SERVICE_UNAVAILABLE
所需的补救措施	否

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

注意

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

错误	代码
HRESULT	0x80131500
HRESULT（十进制）	-2146233088
错误字符串	COR_E_EXCEPTION
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c83073
HRESULT（十进制）	-2134364045
错误字符串	ECS_E_STORAGE_ACCOUNT_FAILED_OVER
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c8020e
HRESULT（十进制）	-2134375922
错误字符串	ECS_E_SYNC_METADATA_WRITE_LEASE_LOST
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c83088
HRESULT（十进制）	-2134364024
错误字符串	ECS_E_INVALID_AAD_TENANT
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c83096
HRESULT（十进制）	-2134364010
错误字符串	ECS_E_MGMT_STORAGEACLSBYPASSNOTSET
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80070005
HRESULT（十进制）	-2147024891
错误字符串	ERROR_ACCESS_DENIED
所需的补救措施	是

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

验证存储帐户上的 SMB 安全设置是否允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。若要查看存储帐户的 SMB 安全设置，请参阅 SMB 安全设置。
验证存储帐户上的防火墙和虚拟网络设置是否已正确配置（如果已启用）
执行以下步骤， 验证 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 文件共享，同步失败。

错误	代码
HRESULT	0x80c8027e
HRESULT（十进制）	-2134375810
错误字符串	ECS_E_SYNC_REPLICA_ROOT_CHANGED
所需的补救措施	是

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

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

删除同步组中的所有服务器终结点。
删除云终结点。
删除同步组。
如果在服务器终结点上启用了云分层，请执行删除服务器终结点后无法在服务器上访问分层文件部分中所述的步骤，以便删除服务器上的独立分层文件。
重新创建同步组。

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

错误	代码
HRESULT	0x80c80254
HRESULT（十进制）	-2134375852
错误字符串	ECS_E_SYNC_REPLICA_BACK_IN_TIME
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80190133
HRESULT（十进制）	-2145844941
错误字符串	HTTP_E_STATUS_REDIRECT_KEEP_VERB
所需的补救措施	是

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

同步会话超时错误。

错误	代码
HRESULT	0x80c8304a
HRESULT（十进制）	-2134364086
错误字符串	ECS_E_WORK_FRAMEWORK_TIMEOUT
所需的补救措施	否

错误	代码
HRESULT	0x80c83049
HRESULT（十进制）	-2134364087
错误字符串	ECS_E_WORK_FRAMEWORK_RESULT_NOT_FOUND
所需的补救措施	否

错误	代码
HRESULT	0x80c83093
HRESULT（十进制）	-2134364013
错误字符串	ECS_E_WORK_RESULT_EXPIRED
所需的补救措施	否

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

操作超时。

错误	代码
HRESULT	0x80131505
HRESULT（十进制）	-2146233083
错误字符串	COR_E_TIMEOUT
所需的补救措施	否

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

超时错误。

错误	代码
HRESULT	0x80c8600d
HRESULT（十进制）	-2134351859
错误字符串	ECS_E_AZURE_OPERATION_TIME_OUT
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c8027a
HRESULT（十进制）	-2134375814
错误字符串	ECS_E_SYNC_ROOT_DIRECTORY_NOT_FOUND
所需的补救措施	是

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

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

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

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

错误	代码
HRESULT	0x80C80299
HRESULT（十进制）	-2134375783
错误字符串	ECS_E_SYNC_AUTHORITATIVE_UPLOAD_EMPTY_SET
所需的补救措施	是

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

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

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

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

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

错误	代码
HRESULT	0x80c83087
HRESULT（十进制）	-2134364025
错误字符串	ECS_E_STORAGE_ACCOUNT_SUBSCRIPTION_DISABLED
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80070040
HRESULT（十进制）	-2147024832
错误字符串	ERROR_NETNAME_DELETED
所需的补救措施	是

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

同步会话错误。

错误	代码
HRESULT	0x80c8300d
HRESULT（十进制）	-2134364147
错误字符串	ECS_E_CANNOT_CREATE_ACTIVE_SESSION_PLACEHOLDER_BLOB
所需的补救措施	否

错误	代码
HRESULT	0x80c8300e
HRESULT（十进制）	-2134364146
错误字符串	ECS_E_CANNOT_UPDATE_REPLICA_WATERMARK
所需的补救措施	否

错误	代码
HRESULT	0x80c8024a
HRESULT（十进制）	-2134375862
错误字符串	ECS_E_SYNC_DEFERRAL_QUEUE_RESTART_SESSION
所需的补救措施	否

错误	代码
HRESULT	0x80c83098
HRESULT（十进制）	-2134364008
错误字符串	ECS_E_STORAGE_ACCOUNT_MGMT_OPERATION_THROTTLED
所需的补救措施	否

错误	代码
HRESULT	0x80c83082
HRESULT（十进制）	-2134364030
错误字符串	ECS_E_ASYNC_WORK_ACTION_UNABLE_TO_RETRY
所需的补救措施	否

错误	代码
HRESULT	0x80c83006
HRESULT（十进制）	-2134364154
错误字符串	ECS_E_ECS_BATCH_ERROR
所需的补救措施	否

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

同步会话错误。

错误	代码
HRESULT	0x80c830a1
HRESULT（十进制）	-2134363999
错误字符串	ECS_TOO_MANY_ETAGVERIFICATION_FAILURES
所需的补救措施	可能

错误	代码
HRESULT	0x80c8023c
HRESULT（十进制）	-2134375876
错误字符串	ECS_E_SYNC_CLOUD_METADATA_CORRUPT
所需的补救措施	可能

错误	代码
HRESULT
HRESULT（十进制）
错误字符串
所需的补救措施	可能

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

发生了内部错误。

错误	代码
HRESULT	0x80070057
HRESULT（十进制）	-2147024809
错误字符串	ERROR_INVALID_PARAMETER
所需的补救措施	否

错误	代码
HRESULT	0x80c80302
HRESULT（十进制）	-2134375678
错误字符串	ECS_E_UNKNOWN_HTTP_SERVER_ERROR
所需的补救措施	否

错误	代码
HRESULT	0x8004100c
HRESULT（十进制）	-2147217396
错误字符串	SYNC_E_DESERIALIZATION
所需的补救措施	否

错误	代码
HRESULT	0x80c8022d
HRESULT（十进制）	-2134375891
错误字符串	ECS_E_SYNC_METADATA_UNCOMMITTED_TX_LIMIT_REACHED
所需的补救措施	否

错误	代码
HRESULT	0x80c83097
HRESULT（十进制）	-2134364009
错误字符串	ECS_E_QUEUE_CLIENT_EXCEPTION
所需的补救措施	否

错误	代码
HRESULT	0x80c80245
HRESULT（十进制）	-2134375867
错误字符串	ECS_E_EPOCH_CHANGE_DETECTED
所需的补救措施	否

错误	代码
HRESULT	0x80072ef3
HRESULT（十进制）	-2147012877
错误字符串	WININET_E_INCORRECT_HANDLE_STATE
所需的补救措施	否

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

发生了内部错误。

错误	代码
HRESULT	0x80131509
HRESULT（十进制）	-2146233079
错误字符串	COR_E_INVALIDOPERATION
所需的补救措施	可能

错误	代码
HRESULT	0x80070718
HRESULT（十进制）	-2147023080
错误字符串	ERROR_NOT_ENOUGH_QUOTA
所需的补救措施	可能

错误	代码
HRESULT	0x80131622
HRESULT（十进制）	-2146232798
错误字符串	COR_E_OBJECTDISPOSED
所需的补救措施	可能

错误	代码
HRESULT	0x80004002
HRESULT（十进制）	-2147467262
错误字符串	E_NOINTERFACE
所需的补救措施	可能

错误	代码
HRESULT	0x800700a1
HRESULT（十进制）	-2147024735
错误字符串	ERROR_BAD_PATHNAME
所需的补救措施	可能

错误	代码
HRESULT	0x8007054f
HRESULT（十进制）	-2147023537
错误字符串	ERROR_INTERNAL_ERROR
所需的补救措施	可能

错误	代码
HRESULT	0x80131501
HRESULT（十进制）	-2146233087
错误字符串	COR_E_SYSTEM
所需的补救措施	可能

错误	代码
HRESULT	0x80131620
HRESULT（十进制）	-2146232800
错误字符串	COR_E_IO
所需的补救措施	可能

错误	代码
HRESULT	0x80070026
HRESULT（十进制）	-2147024858
错误字符串	COR_E_ENDOFSTREAM
所需的补救措施	可能

错误	代码
HRESULT	0x80070554
HRESULT（十进制）	-2147023532
错误字符串	ERROR_NO_SUCH_PACKAGE
所需的补救措施	可能

错误	代码
HRESULT	0x80131537
HRESULT（十进制）	-2146233033
错误字符串	COR_E_FORMAT
所需的补救措施	可能

错误	代码
HRESULT	0x8007001f
HRESULT（十进制）	-2147024865
错误字符串	ERROR_GEN_FAILURE
所需的补救措施	可能

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

发生了内部错误。

错误	代码
HRESULT	0x80004003
HRESULT（十进制）	-2147467261
错误字符串	E_POINTER
所需的补救措施	是

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

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

错误	代码
HRESULT	0x8007052e
HRESULT（十进制）	-2147023570
错误字符串	ERROR_LOGON_FAILURE
所需的补救措施	可能

错误	代码
HRESULT	0x8007051f
HRESULT（十进制）	-2147023585
错误字符串	ERROR_NO_LOGON_SERVERS
所需的补救措施	可能

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

指定的 Azure 帐户已禁用。

错误	代码
HRESULT	0x80c86003
HRESULT（十进制）	-2134351869
错误字符串	ECS_E_AZURE_ACCOUNT_IS_DISABLED
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c8307c
HRESULT（十进制）	-2134364036
错误字符串	ECS_E_STORAGE_ACCOUNT_KEY_BASED_AUTHENTICATION_BLOCKED
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c8003f
HRESULT（十进制）	-2134376385
错误字符串	ECS_E_SYNC_EPOCH_MISMATCH
所需的补救措施	否

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

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

错误	代码
HRESULT	0x80c87104
HRESULT（十进制）	-2134347516
错误字符串	ECS_E_VOLUME_OFFLINE
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c83099
HRESULT（十进制）	-2134364007
错误字符串	ECS_E_PRIVATE_ENDPOINT_ACCESS_BLOCKED
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c80248
HRESULT（十进制）	-2134375864
错误字符串	ECS_E_REPLICA_RECONCILIATION_NEEDED
所需的补救措施	否

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

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

错误	代码
HRESULT	0x800704c3
HRESULT（十进制）	-2147023677
错误字符串	ERROR_SESSION_CREDENTIAL_CONFLICT
所需的补救措施	是

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

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

错误	代码
HRESULT	0x80c80050
HRESULT（十进制）	-2134376368
错误字符串	ECS_E_SERVER_INVALID_OR_EXPIRED_CERTIFICATE
所需的补救措施	是

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

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

常见故障排除步骤

验证存储帐户是否存在。

门户
PowerShell

导航到存储同步服务中的同步组。
选择同步组中的云终结点。
记下打开的窗格中的 Azure 文件共享名称。
选择文件共享名称以打开存储帐户中的文件共享设置页。如果此链接无法打开，则已删除引用的存储帐户。

# 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 文件共享存在。

门户
PowerShell

在左侧目录中选择“概述”以返回到主存储帐户页。
选择“文件”查看文件共享列表。
检查云终结点引用的文件共享是否显示在文件共享列表中（在上述步骤 1 中应已记下此共享名称）。

$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 文件同步有权访问存储帐户。

门户
PowerShell

从左侧导航栏中选择“访问控制(IAM)”。
选择“角色分配”选项卡以列出有权访问你的存储帐户的用户和应用程序（服务主体）。
使用“读取器和数据访问”角色验证列表中是否显示“Microsoft.StorageSync”或“混合文件同步服务”（旧应用程序名称）。

如果“Microsoft.StorageSync”或“混合文件同步服务”没有出现在列表中，请执行以下步骤：
- 选择添加。
- 在“角色”字段中，选择“读者和数据访问”。
- 在“选择”字段中键入 Microsoft.StorageSync，然后选择该角色并单击“保存”。

$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 文件同步同步运行状况问题和错误

同步运行状况

如何监视同步运行状况？

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

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

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

同步错误

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

处理不受支持的字符

常见同步错误

常见故障排除步骤

另请参阅

联系我们寻求帮助

反馈

其他资源