如何排查 SharePoint Server 2016 中的网站集升级问题

适用于:no-img-132013 yes-img-162016 no-img-192019 no-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

在将网站集升级到 SharePoint Server 2016 时,偶尔会发生错误。 本文可帮助您了解这些错误并解决它们。

查看升级状态和日志文件

升级状态指示符和日志文件应会指示升级过程中出现了什么问题。 我们建议您仔细查看升级日志文件中的所有错误。 警告可能并不总是表示存在问题,但还是应查看所有警告,以确定是否有任何警告可能引起更多问题。

  1. 查看网站集的升级状态页。

    On the Site Settings page for the site collection, in the Site Collection Administration section, click Site collection upgrade. On the Site Collection Upgrade page, click Review Site Collection Upgrade Status.

  2. If pages don't render, check the Site Settings page. If the Site Settings page works and the upgrade has succeeded, there might be issues with the master page or home page. If the Site Settings page doesn't work, check the site collection upgrade log file for information about the problem.

  3. 查看网站集升级日志文件。 您可以从以下位置查看网站集升级日志:

  • 对于网站集管理员: 网站集升级的日志文件也存储在网站集本身内部,位于 (http://<SiteName>/_catalogs/MaintenanceLogs/YYYYMMDD-HHMMSS-SSS.txt的“维护日志”目录中,其中 YYYYMMDD 是日期, HHMMSS-SSS 是 24 小时制格式 (小时、分钟、秒和毫秒) 。

  • 对于服务器场管理员: 网站集升级日志文件和升级错误日志文件位于 %COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\16\LOGS。 日志按以下格式命名: SiteUpgrade-YYYYMMDD-HHMMSS-SSS.log,其中 YYYYMMDD 是日期, HHMMSS-SSS 是 24 小时制格式的时间 (小时、分钟、秒和毫秒) 。 若要查看有关问题的详细信息,请参阅文件系统日志。

常见问题

查看以下任何问题是否导致您的网站出现升级错误、警告或问题。

问:我在页面上通常显示 UI 控件的位置未发现 UI 控件

  • 答:将页面重置为默认版本(即重新幻像)。

更改网站 UI 可能会导致网站升级时出现问题。 如果自定义页面以将 UI 控件放置到非标准位置,则您可以将页面重置为默认版本来恢复控件。

若要重置页面,可以使用“网站设置”页上的“网站操作”下的“重置为网站定义”链接,或者使用 SharePoint Designer 中的“重置为模板”命令。

问:大型列表的视图再也无法使用

  • 答: 为大型列表创建索引列、文件夹或新视图。 您可能必须向现有视图添加索引列。

如果某个列表非常大,并且用户使用的视图或执行的查询超过限制或限定阈值,则不允许使用该视图或查询。 可以创建包含筛选视图的索引列,将项组织到文件夹中,在大型视图的页上设置项限制或使用外部列表。 有关大型列表限制以及如何解决大型列表问题的详细信息,请参阅 管理包含许多项的列表和库

问:我发现内容类型名称重复的错误

  • 答:重命名与默认名称冲突的内容类型或字段。

有时,自定义元素(如内容类型)的名称可能与新版本中的名称冲突。

在升级日志文件中,您可能看到以下类似错误:

  • 激活网站集 URL 上的网站集功能失败。 异常:找到重复的内容类型名称“name”。

此错误指示将第三方内容类型添加到了 SharePoint Server 2013 Service Pack 1 (SP1) 中的指定网站。 在升级到 SharePoint Server 2016 期间,其名称与使用同一名称的默认内容类型冲突。 将指定网站集中的第三方内容类型重命名为其他名称并重新运行升级。 有关详细信息,请参阅 创建或自定义网站内容类型

注意

重命名或删除内容类型均可能导致任何依赖该内容类型的自定义项停止工作。

问:我的网站看起来很糟糕、没有按预期运行或发现了脚本错误

  • 答:编辑页面或者将页面重置为默认版本,或者删除或替换自定义文件。

    自定义或内联的 JavaScript 或 CSS 文件的问题可能会导致这些问题。

问:我的网站中的自定义内容消失了或者不工作

  • 答:更改母版页,或更改内容以使其不需要特定区域。

    母版页可能有不同的区域布局且内容可能不再正确地引用它。 作为最后手段,您还可以将页面重置为默认版本。 但是,如果您重置页面,则可能会丢失区域特定的内容。

问:我收到指示无法呈现控件或页面的错误

  • 答:执行下列操作之一:

    • 如果添加了未安装的 Web 部件,请联系服务器场管理员安装它。 如果某个 Web 部件不再可用或不再受支持,则使用 Web 部件维护视图从页面中删除该 Web 部件(删除,而不是仅仅关闭)。

    • 如果直接编辑了某个页面,则重新编辑它以删除控件或 Web 部件,或者将该页面重置为默认版本。

      添加到页面的 Web 部件或其他控件没有安装或不受支持。 将某个 Web 部件添加到了区域中,或者直接编辑页面以直接通过内联方式添加控件或 Web 部件引用(可能在母版页上)。

      SharePoint 功能可能需要激活。 有关详细信息,请参阅启用或禁用网站集功能和打开和使用 Web 部件维护页

问:我升级后的网站根本不呈现;相反,我看到"意外错误"并带有关联 ID

答:您的自定义品牌可能使用了包含自定义内容占位符的自定义母版页。

如果您的自定义母版页包含自定义内容占位符,而且如果自定义页面布局也包含此自定义内容占位符,那么在升级后,可能出现错误,使您的网站主页根本不呈现。 相反,在升级后,您可能看到错误消息"发生意外错误"。

另请参阅

概念

将网站集升级到 SharePoint Server 2016