错误消息中的 SharePoint 相关 ID:它是什么以及如何使用它
应用对象
SharePoint Server 2016 Microsoft 365 中的 SharePoint

如果你是一名用户,在公共网站/调查、电子邮件或其他应用方面遇到问题,请致电拥有该网站的公司寻求帮助。   通常可以在页面底部或导航菜单的“关于”或“联系我们”部分找到网站或调查的联系信息。

如果你是企业的用户,并且遇到错误,请联系管理企业内部网站的人员。   这类问题通常只能由网站管理员(SharePoint 管理员)或公司人员解决。

如果你是 SharePoint 管理员、网站管理员或站点管理员,   而你的用户正在询问有关相关 ID 的问题,本文可以帮助你。

有关相关 ID 的是与否

相关 ID 不是错误号或代码。 简单地说,它是一个 GUID(全局唯一标识符),会为 SharePoint 服务器接收的每个请求自动生成它。 它对于每个请求是唯一的,对每个错误则不是唯一。 但是,发生错误时,错误消息包含当时对请求有效的相关 ID。

相关 ID 用于帮助 SharePoint 管理员跟踪出错时发生的情况。 它只用作一种交互式工具,可帮助管理员跟踪错误。 管理员使用相关 ID 作为“痕迹导航”在 SharePoint统一日志记录系统 (ULS) 中回溯请求或进程,来查找导致问题的原因。 如果 SharePoint 收到在处理该任务时无法识别的错误,则会发布“发生意外错误”消息并包含相关 ID。 相关 ID 可帮助查找发生的情况,但无法识别发生了什么。

示意图显示如何分配相关 ID

成功的请求和失败的请求都使用相关 ID 进行标记。 每个新请求的 ID 不同并且是唯一的,仅在请求的持续时间内有效。 它不像 Windows 错误,提供一个 80xxxxxx 数字来标识确切的问题。 在 Web 上搜索特定相关 ID 没有帮助,因为每个 ID 对于服务器和该时间点都是不同的且唯一的。

相关 ID 的宝贵之处是通过进程进行跟踪。 SharePoint 会创建一个包含在处理请求时执行的各项操作的日志 (ULS),相关 ID 基本上是将每个步骤联系在一起的线程。 由于 SharePoint 同时执行数千个请求,因此可使用相关 ID 筛选出 SharePoint 针对任何给定请求执行的步骤。

对于管理员,可使用相关 ID 来跟踪错误、性能问题和其他问题。 通过对显示有问题行为的请求使用相关 ID,他们可以更深入地调查。  如果未发生任何故障,也没有生成错误消息,可使用开发人员仪表板来查看进程生成的相关 ID。 

如果你是最终用户,则你可能无法访问提供相关 ID 可能有用的信息的日志。 在这种情况下,可在此停止并致电支持人员或管理员。 解释你的问题,并与他们一起帮助诊断问题。 向他们提供你在错误消息上看到的相关 ID,他们可能需要此信息。

作为 IT 专业人员或管理员,若要弄清楚发生了什么,需要查找事件发生时间的 ULS 日志,并在这些日志中搜索相关 ID。 可能需要查看多个 Web 前端才能找到具有你正在查找的相关 ID 的 Web 前端。 相关 ID 无法解决你的错误,但它可以帮助你跟踪请求,看看哪里出现了问题。 你可能会深入了解生成错误之前发生的情况、显示了什么错误消息,或者由于此错误而触发了哪些事件(如果有)。 可以使用 ULSViewer 等工具来方便查看此数据,并筛选掉不需要查看的请求。 有关更多想法和提示,请查看使用 ULSViewer 进行 SharePoint 日志记录和故障排除博客文章。

下面是管理员在使用相关 ID 时使用的典型场景:

  • 用户在 Excel 中打开文件时收到错误,这为管理员提供了事件的相关 ID 和日期/时间:

  • 找到日志目录和要查找的日期,并在 Excel 中打开该文件:

  • 找到要查找的相关 ID。 还可以按事件级别进行筛选,了解正在发生什么:

  • 如果找不到相关 ID,请尝试报告问题时正在轮换的另一台 Web 服务器。

下面是一些更多的管理员资源,可帮助调试 SharePoint 错误。 除了这些链接,还请尝试搜索 Web,上面有许多第三方网站和社区提供便于使用 SharePoint 的支持和工具。 SharePoint 是一个平台,因此有成千上万的开发人员、IT 专业人员和用户组成的社区开发工具、应用和文档来相互帮助。

需要更多帮助?

需要更多选项?

了解订阅权益、浏览培训课程、了解如何保护设备等。