概述
整个系统的剪贴板突然无法读写,
Set-Clipboard/Get-Clipboard都报”所请求的剪贴板操作失败”。本文记录一次定位过程,并给出可复用的脚本,用于找出当前打开剪贴板而未关闭的进程。
相关说明
剪贴板是系统全局资源,同一时刻只能有一个窗口通过
OpenClipboard打开它,必须配对CloseClipboard释放。某个程序打开后不关闭,其他程序就全部失败。
[toc]
系统剪贴板被占用排查:定位 OpenClipboard 持有者
1. 现象
在 PowerShell 中执行以下命令,均报错:
powershell
Set-Clipboard -Value "test123"
Get-Clipboard报错信息为 ExternalException,文字为”所请求的剪贴板操作失败”。Set-Clipboard 耗时约 1.26 秒,说明 PowerShell 内部重试数次后才放弃。
读和写都失败,说明问题不在某次数据内容,而是剪贴板根本打不开,即 OpenClipboard 失败(CLIPBRD_E_CANT_OPEN)。
2. 排查思路
- 确认是否为全局占用:读、写均失败,基本可以排除单个数据格式的问题。
- 找出持有者:系统没有直接列出”谁持有剪贴板”的命令,但 user32 提供了
GetOpenClipboardWindow(),它返回当前打开剪贴板的窗口句柄。再用GetWindowThreadProcessId()把窗口反查到进程 ID。 - 判断是否假死:
Get-Process的Responding字段为True表示消息循环仍在工作,程序没有卡死,而是打开剪贴板后没有释放。
3. 排查脚本
脚本保存在本文同目录下:find-clip-owner.ps1
powershell
Add-Type -MemberDefinition @'
[DllImport("user32.dll")] public static extern IntPtr GetOpenClipboardWindow();
[DllImport("user32.dll")] public static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint processId);
'@ -Name Clip -Namespace Native
$hwnd = [Native.Clip]::GetOpenClipboardWindow()
Write-Output ("Open clipboard window handle: 0x{0:X}" -f $hwnd.ToInt64())
if ($hwnd -eq [IntPtr]::Zero) {
Write-Output "No process currently holds the clipboard open (the occupation may be transient)."
exit 0
}
$ownerPid = [uint32]0
[void][Native.Clip]::GetWindowThreadProcessId($hwnd, [ref]$ownerPid)
Get-Process -Id $ownerPid -ErrorAction SilentlyContinue |
Select-Object Id, ProcessName, Responding, Path |
Format-List运行方式:
powershell
powershell -ExecutionPolicy Bypass -File find-clip-owner.ps1注意:脚本只能抓取运行那一刻持有剪贴板的窗口。如果占用是间歇性的,输出可能为”没有进程持有”,需要在卡住的时候立即运行,必要时多跑几次。
4. 实际定位结果
在卡顿期间运行脚本,输出如下:
Open clipboard window handle: 0x6E923E2
Id : 90076
ProcessName : GameViewer
Responding : True
Path : C:\Program Files\Netease\GameViewer\bin\GameViewer.exe
持有者为网易 GameViewer(远程控制/屏幕共享工具)。Responding: True 说明它没有假死,而是打开剪贴板后未释放。
5. 结论与处理
- 本次根因:GameViewer 占用剪贴板未释放,导致系统级剪贴板不可用。这属于第三方程序的行为,不是系统故障。
- 排除项:同期排查的 clipboard-spike(ClipSense)未出现在持有者中,与此次问题无关。两者属于不同问题,不要混为一谈。
- 处理方式:退出 GameViewer(注意退出会断开正在进行的远程会话),然后重新执行
Set-Clipboard/Get-Clipboard验证是否恢复。若不想退出,可以用Stop-Process -Id <PID>强制结束,但会丢失该程序的状态,应谨慎使用。
6. 通用经验
- 剪贴板”卡住”时,先用
GetOpenClipboardWindow定位持有者,比重启资源管理器或系统更精确、代价更小。 - 持有者
Responding: True说明是程序逻辑未释放资源,False则更像程序假死。 - 排查时要区分”系统剪贴板被占用”与”应用内粘贴失效”两类问题,它们的报错和定位手段完全不同。