MouseKeyHook无法捕获跨应用选中文本事件问题排查求助

架构老林

2026-8-27

问题描述

我正在开发一款驻留系统托盘的查词应用，预期交互逻辑为：用户选中若干词组后，按下例如Shift + C + V的自定义热键组合即可触发查词功能。
目前遇到的问题是：在个人开发机上测试时功能运行完全正常，但在测试人员的设备上，程序无法捕获选中文本对应的事件。当前使用MouseKeyHook库实现全局键鼠事件监听，核心实现代码如下：

public partial class Main : Form
{
    private int borderSize = 2;
    private Color borderColor = Color.FromArgb(128, 128, 255);

    ManageDictionary manage;
    MySqlConnection conn;

    private IKeyboardMouseEvents globalMouseHook;

    [DllImport("user32.DLL", EntryPoint = "ReleaseCapture")]
    private extern static void ReleaseCapture();
    [DllImport("user32.DLL", EntryPoint = "SendMessage")]
    private extern static void SendMessage(System.IntPtr hWnd, int wMsg, int wParam, int lParam);
    [DllImport("user32.dll", SetLastError = true)]
    public static extern IntPtr SetActiveWindow(IntPtr hWnd);
    private int isOpen;
    public Main()
    {
        InitializeComponent();
        
        this.FormBorderStyle = FormBorderStyle.None;
        this.Padding = new Padding(borderSize);
        this.panel2.BackColor = borderColor;
        this.BackColor = borderColor;

        this.Subscribe();

        manage = new ManageDictionary();

        conn = ConnectDB.Connect();

        SetActiveWindow(this.Handle);

    }
    private void Subscribe()
    {
        globalMouseHook = Hook.GlobalEvents();

        globalMouseHook.MouseDragFinished += MouseDragFinished;
    }

    private void Unsubscribe()
    {
        globalMouseHook.MouseDragFinished -= MouseDragFinished;

        globalMouseHook.Dispose();
    }

    private void resetConnection()
    {
        conn.Close();
        conn = ConnectDB.Connect();
        isOpen = 0;
    } 
    
    private void showResult()
    {
        string content = this.txtSearch.Text.Trim();
        if (content.Equals(""))
        {
            MessageBox.Show("Không tìm thấy từ khoá");
            return;
        }
        else
        {
            this.displayNotification(content);
        }
        
    }

    private void displayNotification(string content)
    {
        ArrayList re = new ArrayList();
        try
        {
            //If the connection isn't open, it will open and set value of isOpen parameter to 1
            conn.Open();
            
            re = manage.findWord(conn, content);

            if (re.Count == 0)
            {
                Dictionary a = new Dictionary(0, "Không tìm thấy kết quả", "", "", "", "");
                re.Add(a);
                Notification noti = new Notification(re, content);
                noti.TopMost = true;
                Thread.Sleep(100);
                noti.Show();
            }
            else
            {
                Notification noti = new Notification(re, content);
                noti.TopMost = true;
                Thread.Sleep(2000);
                noti.Show();
            }
        }
        catch (MySqlException)
        {
            MessageBox.Show("MySQL chưa được khởi động hoặc tên CSDL bị sai\r\nVui lòng kiểm tra lại");
        }
        catch (SocketException)
        {
            MessageBox.Show("Không kết nối được với cơ sở dữ liệu");
        }
        catch (Exception ex)
        {
            MessageBox.Show("Kết nối thất bại\r\n"+ ex.Message);
        }
        conn.Close();
        isOpen = 0;
    }
}

原因排查与修复方案

权限隔离导致钩子失效
Windows UAC机制会隔离不同权限层级的窗口消息：如果测试机上用户选中文本的目标程序（浏览器、Office、终端等）是以管理员权限启动的，而你的查词工具运行在普通用户权限下，系统会直接拦截你的全局钩子，无法收到高权限程序的鼠标事件。
修复：给程序添加应用清单文件，配置合适的执行级别；如果需要兼容管理员权限运行的目标程序，你的查词工具也需要以管理员权限启动。
高DPI适配缺失导致拖拽事件不触发
如果测试机开启了125%/150%及以上的系统显示缩放，旧版本MouseKeyHook会出现坐标计算偏差，无法正确识别鼠标拖拽选文本的动作，自然不会触发MouseDragFinished事件。
修复：在程序清单中开启Per-Monitor级别的高DPI感知，同时将MouseKeyHook升级到最新稳定版本。
钩子注册时机错误、易被抢占
你现在在主窗体构造函数中注册全局钩子，此时窗体句柄还未完全初始化，部分系统环境下会出现钩子假注册、不生效的问题。另外测试机上如果安装了其他带全局钩子的程序（输入法、截图工具、热键工具、游戏反作弊组件），会抢占钩子消息链路，排在链路后面的程序收不到事件。
修复：把钩子注册逻辑从构造函数移到窗体OnLoad/Shown事件中执行；不要仅依赖MouseDragFinished判断选中文本——这个逻辑本身覆盖不全，无法识别键盘Shift+方向键选文本、双击选词、触控板选文本等场景。
现有实现逻辑本身存在稳定性缺陷
你当前的设计是等鼠标拖拽结束后再等热键触发，本身就不符合全局热键工具的稳定实现逻辑，而且你在UI线程直接调用Thread.Sleep()阻塞，会导致窗口消息泵卡住。Windows对全局钩子有严格的超时限制，钩子过程长时间无响应会被系统自动卸载，这也是很多机器上程序跑一段时间就失效的核心原因。
推荐重构交互逻辑：
1. 直接用系统RegisterHotKeyAPI注册全局热键，不要用键盘钩子自己判断组合键，系统级热键的兼容性和稳定性远高于自定义钩子判断
2. 热键触发时，先暂存当前剪贴板内容，向当前激活的前台窗口发送WM_COPY复制消息，等待几十毫秒后从剪贴板读取用户选中的文本，读取完成后恢复用户原有剪贴板内容，全程不依赖鼠标事件判断，所有选中文本的场景都能兼容
3. 移除UI线程上的所有Thread.Sleep()调用，需要延迟执行逻辑时用窗体Timer实现，避免阻塞消息泵导致钩子被系统移除。

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