PyWin32中HookMessage注册的处理器PostMessage后未触发问题

使用pywin32的pywin.mfc模块开发Windows应用时遇到如下问题：

• 调用PyCWnd.PostMessage()发送WM_USER自定义消息时，通过PyCWnd.HookMessage()注册的处理方法完全没触发
• 但用PyCWnd.SendMessage()发送同一条消息时，处理方法能正常执行
• 怀疑是自定义消息泵不兼容Pythonwin框架，但无法确认

测试脚本如下：

import win32con
import win32gui
import win32ui

from pywin.mfc.thread import WinApp
from pywin.mfc.window import MDIFrameWnd

app = WinApp()
frame = MDIFrameWnd()
app.SetMainFrame(frame)
frame.LoadFrame(
    win32ui.IDR_MAINFRAME,
    win32con.WS_OVERLAPPEDWINDOW,
)
frame.UpdateWindow()


def OnUser(params):
    print("OnUser")


frame.HookMessage(OnUser, win32con.WM_USER)  # 期望收到WM_USER时打印"OnUser"
frame.SendMessage(win32con.WM_USER, 0, 0)  # 立即打印"OnUser"，正常工作
frame.PostMessage(win32con.WM_USER, 0, 0)  # 期望后续异步打印"OnUser"，但未触发


def PumpWaitingMessages():
    available = 1
    should_quit = 0
    while available:
        available, msg = win32gui.PeekMessage(0, 0, 0, win32con.PM_REMOVE)
        if available:
            if msg[1] == win32con.WM_QUIT:
                should_quit = 1
                break
            win32gui.TranslateMessage(msg)
            print(msg)  # 能看到Post的消息到达这里
            win32gui.DispatchMessage(msg)  # 但Dispatch后没有触发处理方法
    return should_quit


while not PumpWaitingMessages():
    pass

期望效果：调用frame.PostMessage(win32con.WM_USER, 0, 0)后，异步打印"OnUser"。

问题核心出在自定义消息泵的实现逻辑：

• PyCWnd.HookMessage()注册的处理方法是绑定在MFC框架的消息处理体系内的，不属于系统原生窗口过程的一部分
• 你用win32gui.DispatchMessage()会直接调用系统默认窗口过程，完全绕开了MFC的消息映射和Hook回调逻辑
• SendMessage()是同步调用，直接进入MFC的消息处理流程，所以能触发Hook方法；但PostMessage()的消息进入队列后，被自定义泵用原生Dispatch处理，自然无法触发MFC绑定的回调

不要手动实现基于win32gui的消息泵，改用MFC框架提供的标准消息循环机制：

• 使用WinApp.Run()启动MFC原生消息泵，它会正确处理MFC窗口的消息映射和Hook回调
• 如果必须保留自定义泵逻辑，也要基于MFC提供的方法（比如WinApp的PeekMessage/DispatchMessage）来处理消息

修改后的最简代码 #

import win32con
import win32ui

from pywin.mfc.thread import WinApp
from pywin.mfc.window import MDIFrameWnd

app = WinApp()
frame = MDIFrameWnd()
app.SetMainFrame(frame)
frame.LoadFrame(
    win32ui.IDR_MAINFRAME,
    win32con.WS_OVERLAPPEDWINDOW,
)
frame.UpdateWindow()


def OnUser(params):
    print("OnUser")


frame.HookMessage(OnUser, win32con.WM_USER)
frame.SendMessage(win32con.WM_USER, 0, 0)
frame.PostMessage(win32con.WM_USER, 0, 0)

# 使用MFC标准消息泵，自动处理所有MFC绑定的消息回调
app.Run()

自定义消息泵的兼容写法 #

如果需要保留自定义逻辑，要基于MFC的方法实现消息循环：

import win32con
import win32gui
import win32ui

from pywin.mfc.thread import WinApp
from pywin.mfc.window import MDIFrameWnd

app = WinApp()
frame = MDIFrameWnd()
app.SetMainFrame(frame)
frame.LoadFrame(
    win32ui.IDR_MAINFRAME,
    win32con.WS_OVERLAPPEDWINDOW,
)
frame.UpdateWindow()


def OnUser(params):
    print("OnUser")


frame.HookMessage(OnUser, win32con.WM_USER)
frame.SendMessage(win32con.WM_USER, 0, 0)
frame.PostMessage(win32con.WM_USER, 0, 0)


def PumpWaitingMessages():
    msg = win32gui.PYMSG()
    should_quit = 0
    # 使用MFC的PeekMessage和DispatchMessage方法
    while app.PeekMessage(msg, 0, 0, 0, win32con.PM_REMOVE):
        if msg.message == win32con.WM_QUIT:
            should_quit = 1
            break
        app.TranslateMessage(msg)
        app.DispatchMessage(msg)
    return should_quit


while not PumpWaitingMessages():
    pass

MFC的消息处理是对Windows原生消息机制的封装，HookMessage属于这个封装层的功能。原生win32gui的消息处理函数无法触发MFC的钩子和消息映射，必须使用MFC提供的消息循环方法，才能让PostMessage发送的消息被正确处理。

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