SharePoint Online连接正常但Get-PnPFile下载文件失败求助

针对你遇到的问题，结合已完成的排查项，可从以下方向继续排查：

• 检查公司网络代理与防火墙规则

  • 确认服务器是否通过代理访问互联网，代理是否允许SharePoint的文件传输请求（部分代理会拦截分块传输或大文件下载）。可直接在服务器上用浏览器尝试下载目标文件，验证基础网络传输是否正常。
  • 排查防火墙是否限制了长连接超时或阻断了HTTPS的特定扩展字段，下载文件需要持续的TCP连接，部分防火墙会强制断开长时间未活动的连接。

• 验证TLS版本配置

  • SharePoint Online要求使用TLS 1.2及以上版本，尽管.NET 4.8默认支持，但服务器可能通过组策略禁用了高版本TLS。运行以下命令检查配置：

    Get-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319' | Select-Object SchUseStrongCrypto
    Get-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client' | Select-Object Enabled, DisabledByDefault
    

  • 若SchUseStrongCrypto值不为1，或TLS 1.2未启用，需修改对应注册表项开启（操作前请备份注册表）。

• 更新PnP PowerShell模块版本

  • 服务器上的PnP模块可能存在版本兼容性问题，旧版本可能对SharePoint的新传输协议支持不足。执行以下命令检查并更新：

    # 查看当前安装的版本
    Get-Module -Name PnP.PowerShell -ListAvailable
    # 更新到最新版本
    Install-Module -Name PnP.PowerShell -Force -AllowClobber
    

  • 更新后重新连接并测试下载。

• 测试小文件下载与分块参数调整

  • 先尝试下载几KB大小的测试文件，若成功则说明大文件的分块传输被网络设备拦截。可调整Get-PnPFile的分块大小参数，例如：

    Get-PnPFile -Url "/sites/xxx/Documents/test.docx" -Path "C:\temp" -FileName "test.docx" -ChunkSize 1048576
    

  • 逐步调整分块大小，找到网络允许的最大值。

• 检查网络连接稳定性

  • 用以下命令测试服务器到SharePoint站点的连接质量：

    Test-NetConnection -HostName your-sharepoint-site-url -Port 443 -InformationLevel Detailed
    

  • 也可使用tracert或pathping命令排查路由节点是否存在丢包、延迟过高的情况，这些都可能导致连接被强制关闭。

• 验证身份认证会话有效性

  • 尽管初始连接正常，但下载时的身份认证上下文可能失效。尝试使用交互式登录重新连接：

    Connect-PnPOnline -Url "https://your-sharepoint-site-url" -UseWebLogin
    

  • 登录后再次执行Get-PnPFile，排除非交互式认证的会话问题。

内容的提问来源于stack exchange，提问作者pgbfnf