Get-PnPSiteTemplate提取模板时部分Handler卡顿问题求助

背景 #

组织需自动化复制SharePoint站点配置（含带特定列/视图的库、列表，以及带Quick Links的主页），库和列表已用Site Script完成，主页依赖PnP PowerShell。运行Get-PnPSiteTemplate时，已排除ApplicationLifecycleManagement和ImageRenditions handlers，但卡在Navigation Handler，卡顿终端会额外出现命令提示符，trace日志信息有限，需保留导航配置的前提下解决问题。

1. 升级日志级别捕获详细导航处理信息 #

默认Trace日志级别不足以定位问题，调整为Debug级别后重新运行脚本，获取导航处理阶段的细节：

$siteUrl = "https://mytenant.sharepoint.com/sites/MyClientTemplate"
Connect-PnPOnline -Url $siteUrl -Interactive
Set-PnPTraceLog -On -LogFile traceoutput.txt -Level Debug
Get-PnPSiteTemplate -Out template.xml

查看日志中Navigation Handler阶段的记录，重点排查是否存在：

• 指向已删除/权限受限资源的导航链接
• 大量自定义导航节点（如超过50个）
• 结构化导航关联的大型列表/库异常

2. 单独提取导航模板，缩小问题范围 #

跳过全站点模板提取，仅提取导航相关配置，验证是否是导航本身导致卡顿：

Get-PnPSiteTemplate -Out navigation-only.xml -Handlers Navigation

如果单独提取仍卡顿，直接检查站点导航的异常点：

• 清理冗余、无效的导航节点
• 检查是否启用了结构化导航且数据源存在访问问题
• 验证导航节点的权限配置是否存在循环或冲突

3. 简化导航配置后测试 #

临时简化导航配置，排除干扰项：

• 删除非核心的导航链接，只保留必要节点
• 将指向外部/异常资源的链接替换为当前站点内的有效页面
• 暂时切换为友好URL导航（若之前使用结构化导航）
  重新运行模板提取脚本，若卡顿消失，再逐步恢复导航配置，定位具体导致问题的节点。

4. 更新PnP PowerShell至最新稳定版 #

旧版本PnP PowerShell可能存在导航处理的已知bug，执行更新后重试：

Update-Module -Name PnP.PowerShell -Force

5. 排查执行环境的潜在干扰 #

脚本卡顿时出现额外命令提示符，可能和执行环境有关：

• 在全新的PowerShell窗口中运行脚本，避免会话残留问题
• 关闭OneDrive同步进程（输出文件存于OneDrive目录时，同步可能导致文件锁定）
• 将输出文件路径改为本地非同步目录，比如C:\temp\template.xml

内容的提问来源于stack exchange，提问作者Rachel Piotraschke Organist