MFC遗留应用启动时OnInitialUpdate被调用两次的问题排查

老哥，这个MFC遗留应用里OnInitialUpdate被调用两次的坑我太熟了，本质是你手动创建主窗口的流程和MFC框架的预期不符，咱们一步步拆解根因和解决方案：

根因拆解 #

你当前的InitInstance流程是先手动创建CMainFrame并调用LoadFrame，之后才添加文档模板，这和MFC标准流程完全反了，直接导致了两次调用：

1. 第一次调用：来自CSplitterWnd::CreateView
   在CMainFrame::OnCreateClient里调用CreateView时，传入的pContext是nullptr——因为你手动调用LoadFrame时，框架还没创建文档模板，自然没有生成包含文档/视图关联信息的CCreateContext对象。而MFC的CSplitterWnd::CreateView逻辑是：如果传入的pContext为nullptr，就会主动给新创建的视图发送WM_INITIALUPDATE，这就是第一次调用的来源，你说这个符合文档预期是对的，但问题出在第二次。
2. 第二次调用：来自CFrameWnd::LoadFrame的广播
   LoadFrame函数执行到最后，会调用SendMessageToDescendants(WM_INITIALUPDATE)，给所有子视图广播这个消息，这就触发了第二次OnInitialUpdate调用。

另外你提到OnCreateClient里两次调用CreateView，如果这两次是创建同一类视图（甚至同一实例），那这个广播消息会同时触发两次视图的OnInitialUpdate，雪上加霜。

解决方案（按优先级排序） #

方案1：回归MFC标准流程（最优解） #

把添加文档模板的代码移到创建主窗口之前，让框架自动负责主窗口、文档、视图的关联创建，这是最稳妥的方式，完全符合MFC设计预期：

BOOL CMyApp::InitInstance()
{
    // 先创建并添加文档模板
    CSingleDocTemplate* const pDocTemplate = new CSingleDocTemplate(
        IDR_MAINFRAME,
        RUNTIME_CLASS(CMenuDoc),
        RUNTIME_CLASS(CMainFrame),
        RUNTIME_CLASS(CMenuView));
    if (!pDocTemplate)
        return FALSE;
    AddDocTemplate(pDocTemplate);

    // 由框架自动处理窗口创建（替代你手动new CMainFrame和LoadFrame的逻辑）
    CCommandLineInfo cmdInfo;
    ParseCommandLine(cmdInfo);
    if (!ProcessShellCommand(cmdInfo))
        return FALSE;

    m_pMainWnd->ShowWindow(SW_SHOW);
    m_pMainWnd->UpdateWindow();

    return TRUE;
}

这样框架创建主窗口时，会把完整的CCreateContext传递给OnCreateClient，此时CreateView拿到非空的上下文，就不会主动发送WM_INITIALUPDATE，而是由框架在文档-视图关联完成后统一调用一次，彻底解决重复问题。

方案2：视图内加标记位兼容（治标不治本） #

如果因为遗留代码限制，没法修改InitInstance流程，那可以在视图类里加一个标记位，避免重复执行初始化逻辑：

class CMenuView : public CView
{
private:
    bool m_bInitialUpdateDone = false; // 初始化标记位
    // ... 其他成员
};

void CMenuView::OnInitialUpdate()
{
    if (m_bInitialUpdateDone)
        return; // 已经执行过，直接返回
    m_bInitialUpdateDone = true;

    // 原来的初始化代码
    CView::OnInitialUpdate();
    // ... 你的业务逻辑
}

这个方式简单粗暴，但只是规避问题，没有从根源解决框架流程的不一致，适合临时兼容。

方案3：手动构造CCreateContext（不推荐） #

如果你必须保留手动LoadFrame的逻辑，可以在OnCreateClient里手动构造有效的CCreateContext，传递给CreateView：

BOOL CMainFrame::OnCreateClient(LPCREATESTRUCT lpcs, CCreateContext* pContext)
{
    CCreateContext localCtx;
    if (!pContext)
    {
        // 手动构造上下文，确保包含文档指针
        localCtx.m_pCurrentDoc = GetActiveDocument();
        localCtx.m_pNewViewClass = RUNTIME_CLASS(CMenuView);
        localCtx.m_pCurrentFrame = this;
        pContext = &localCtx;
    }

    if (!Splitter.CreateStatic(this, 2, 2))
        return FALSE;
    if (!Splitter.CreateView(0, 0, RUNTIME_CLASS(MyView), CSize(0,0), pContext))
        return FALSE;
    if (!Splitter.CreateView(1, 1, RUNTIME_CLASS(CMenuView), CSize(0,0), pContext))
        return FALSE;

    return TRUE;
}

这样CreateView因为拿到了非空的上下文，就不会主动发送WM_INITIALUPDATE，只会响应框架的一次广播。但这个方式依赖GetActiveDocument()能拿到有效指针，而手动LoadFrame时文档可能还没创建，风险较高，不推荐作为长期解决方案。

总结 #

核心问题就是手动创建主窗口的流程违反了MFC的设计逻辑，导致上下文缺失，触发了两次WM_INITIALUPDATE。优先推荐回归标准流程，这是最稳定、最符合框架设计的解决方式。

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