已发布C++接口扩展兼容问题：更新API后旧程序崩溃求助

问题根源 #

直接让IMonitorManaged继承IDebug会修改基类的虚函数表（vtable）布局，旧程序编译时记录的虚函数偏移量与新DLL的vtable不匹配，导致函数调用错位——比如原本调用GetAssemblyVersion()的偏移地址现在指向了Close()，最终引发内存访问异常。

解决方案（类COM接口查询模式） #

1. 保留原有基类结构，新增独立扩展接口 #

不修改IMonitorManaged的继承关系，避免破坏旧vtable布局。单独定义IDebug接口承载新功能：

class IDebug {
public:
    virtual void DebugLog(const char* msg) = 0;
    virtual bool IsDebugEnabled() = 0;
    // 其他新增调试方法
};

2. 在原有基类末尾添加接口查询方法 #

在IMonitorManaged的所有旧虚函数之后新增QueryInterface虚函数，用于动态判断接口支持情况：

class IMonitorManaged {
public:
    // 原有方法完全保留，顺序绝对不能修改
    virtual const char* GetAssemblyVersion() = 0;
    virtual void Close() = 0;
    // ... 其他旧方法

    // 新增查询方法，必须放在旧方法之后
    virtual void* QueryInterface(const char* interfaceId) {
        return nullptr; // 默认返回空，代表不支持目标接口
    }
};

接口ID可以用字符串（如"IDebug"）、全局常量指针或UUID，确保唯一性即可。

3. 子类同时实现原有接口与扩展接口 #

让IHardwareMonitorManaged、IProgramMonitorManaged多继承IMonitorManaged和IDebug，并实现QueryInterface方法：

class IHardwareMonitorManaged : public IMonitorManaged, public IDebug {
public:
    // 原有方法实现（包含Bug修复）
    const char* GetAssemblyVersion() override { /* 修复后的逻辑 */ }
    void Close() override { /* 修复后的逻辑 */ }

    // IDebug接口方法实现
    void DebugLog(const char* msg) override { /* 新功能逻辑 */ }
    bool IsDebugEnabled() override { /* 新功能逻辑 */ }

    // 重写QueryInterface，返回对应接口指针
    void* QueryInterface(const char* interfaceId) override {
        if (strcmp(interfaceId, "IDebug") == 0) {
            return static_cast<IDebug*>(this);
        }
        // 后续新增其他接口时，可在此添加判断
        return IMonitorManaged::QueryInterface(interfaceId);
    }
};

4. 新程序调用扩展功能的方式 #

先获取原有实例，再通过QueryInterface动态检测并调用新功能：

IMonitorManaged* monitor = GetHardwareMonitor();
// 调用原有方法，完全兼容旧逻辑
const char* version = monitor->GetAssemblyVersion();

// 查询IDebug接口
IDebug* debug = static_cast<IDebug*>(monitor->QueryInterface("IDebug"));
if (debug != nullptr) {
    debug->DebugLog("Debug info from updated API");
    // 无需单独释放debug，与monitor为同一实例，释放monitor即可
}

// 调用原有Close方法
monitor->Close();

5. 兼容性保障关键细节 #

• 绝对不能修改原有基类的虚函数顺序，新增的QueryInterface必须放在所有旧方法之后，确保旧程序的函数偏移量完全匹配。
• Bug修复仅在原有方法的实现中进行，不修改方法签名、参数或返回值。
• 导出函数GetHardwareMonitor()、GetProgramMonitor()的签名保持不变，仍返回IMonitorManaged*类型。

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