C# WPF开发触发InvalidOperationException异常的问题排查与修复

问题核心根源 #

• 异常触发的直接原因：代码在MainWindow构造函数内，创建了间隔仅1毫秒的定时器并直接启动。System.Timers.Timer的Elapsed事件默认在线程池线程触发，回调中通过Dispatcher.Invoke抛到UI线程执行的鼠标捕获、坐标转换逻辑，执行时MainWindow的原生窗口句柄（HWND）、视觉树关联的呈现源（PresentationSource）还未完成初始化。
• WPF运行机制中，Mouse.Capture()、PointToScreen()这类需要和窗口硬件层交互的API，必须要求窗口已经实际完成加载流程、关联到有效的HWND才能正常调用，否则就会抛出InvalidOperationException。WPF的Window类是惰性创建HWND的，哪怕构造函数执行完InitializeComponent()，只要窗口还没被实际渲染到屏幕、触发Loaded事件，相关硬件关联资源就未就绪。设置的1ms间隔过短，让定时器在窗口还没走完加载流程时就触发了回调，自然无法调用需要硬件支持的API。
• 代码中的隐藏隐患：构造函数中创建的WinForms风格NotifyIcon是方法内的局部变量，没有被类的成员引用持有，构造函数执行完成后会被GC回收，后续托盘图标会无理由消失，甚至可能触发WinForms组件的句柄访问异常。

具体修复方案 #

所有调整严格遵守原代码中「Please do not edit here」区域的代码不做修改的约束，仅调整执行时机和引用关系：

• 调整定时器启动时机：把原本写在构造函数中的timer.Start()调用，移动到MainWindow的Loaded事件回调里，等窗口完全加载完成、HWND就绪后再启动定时器，保证定时器回调执行时，所有依赖硬件句柄的API都可以正常访问。
• 修正过短的定时器间隔：把1ms的间隔调整为符合实际使用场景的合理值（建议100ms以上），避免高频无意义的线程切换，减少不必要的系统资源占用。
• 修正NotifyIcon的引用逻辑：把构造函数内的noti局部变量，提升为MainWindow类的私有字段，确保整个窗口生命周期内该实例不会被GC回收，托盘图标可以稳定显示。
• 增加资源释放逻辑：因为System.Timers.Timer和NotifyIcon都是关联非托管资源的组件，需要在窗口的Closed事件里手动停止定时器、释放组件资源，避免长期运行的内存泄漏。

修复后参考代码 #

namespace Test
{
    public partial class MainWindow : Window
    {
        // 将NotifyIcon提升为类私有字段，防止构造函数执行完后被GC回收
        private System.Windows.Forms.NotifyIcon _notifyIcon;
        private System.Timers.Timer _captureTimer;

        public MainWindow()
        {
            InitializeComponent();

            // 完全保留原标记区域的代码逻辑不做修改
            _captureTimer = new System.Timers.Timer();
            _captureTimer.Elapsed += delegate
            {
                Dispatcher.Invoke(new Action(delegate
                {
                    Mouse.Capture(this);
                    System.Windows.Point pointToWindow = Mouse.GetPosition(this);
                    System.Windows.Point pointToScreen = PointToScreen(pointToWindow);
                    Mouse.Capture(null);
                }));
            };
            // 调整为合理的触发间隔
            _captureTimer.Interval = 100;
            _captureTimer.AutoReset = true;
            // 原代码中的timer.Start()从这里移除，改到Loaded事件中执行

            // 系统托盘初始化逻辑
            var menu = new System.Windows.Forms.ContextMenu();
            _notifyIcon = new System.Windows.Forms.NotifyIcon
            {
                Icon = Properties.Resources.Icon,
                Visible = true,
                Text = "title",
                ContextMenu = menu,
            };
            var item = new System.Windows.Forms.MenuItem
            {
                Index = 0,
                Text = "bye"
            };
            item.Click += (object o, EventArgs e) =>
            {
                System.Windows.Application.Current.Shutdown();
            };
            menu.MenuItems.Add(item);
            _notifyIcon.ContextMenu = menu;

            // 注册窗口事件
            Loaded += MainWindow_Loaded;
            Closed += MainWindow_Closed;
        }

        private void MainWindow_Loaded(object sender, RoutedEventArgs e)
        {
            // 窗口完全加载完成、HWND就绪后再启动定时器
            _captureTimer.Start();
        }

        private void MainWindow_Closed(object sender, EventArgs e)
        {
            // 手动释放非托管关联资源
            _captureTimer.Stop();
            _captureTimer.Dispose();
            _notifyIcon.Visible = false;
            _notifyIcon.Dispose();
        }
    }
}

内容的提问来源于stack exchange，提问作者김영민