Boost单元测试中全局变量导致测试用例隔离失效的解决办法

以下是几种可行的解决方法，按推荐程度排序：

方法1：给生产代码增加测试专用重置接口（最推荐） #

如果有权限修改core模块的代码，直接新增一个重置全局变量的接口，专门供测试用例使用，既能保证测试隔离，又不影响生产逻辑。

修改core.h，添加测试专用接口（用条件编译避免进入发布版本）：

#ifdef BOOST_TEST_MODULE
void resetGlobalVar();
#endif

int globalMethod(bool flag);

修改core.cpp，实现重置函数：

#include "core.h"
bool globalVar = false;

int globalMethod(bool flag) {
   if(flag)
   {
        globalVar = true;
        return true;
   }
   return false;
}

#ifdef BOOST_TEST_MODULE
void resetGlobalVar() {
    globalVar = false;
}
#endif

然后在测试代码中使用Boost Fixture，确保每个测试用例前后都重置全局变量：

#include <boost/test/unit_test.hpp>
#include <api/core.h>
#include <myfolder/myextns.h>

struct GlobalVarFixture {
    GlobalVarFixture() {
        resetGlobalVar(); // 测试前初始化状态
    }
    ~GlobalVarFixture() {
        resetGlobalVar(); // 测试后清理状态，避免影响其他用例
    }
};

BOOST_FIXTURE_TEST_SUITE(ourextns, GlobalVarFixture)
BOOST_FIXTURE_TEST_SUITE(myextns, GlobalVarFixture)

BOOST_AUTO_TEST_CASE(case1)
{
    globalMethod(true);
    bool result = myFirstMethod();
    BOOST_REQUIRE(result);
}

BOOST_AUTO_TEST_CASE(case2)
{
    someother_api_method();
    bool result = mySecondMethod();
    BOOST_REQUIRE(result);
}

BOOST_AUTO_TEST_SUITE_END()
BOOST_AUTO_TEST_SUITE_END()

方法2：利用链接器特性替换全局变量（无需修改生产代码） #

如果无法修改生产代码，可以借助编译器的弱符号特性，在测试文件中定义同名的全局变量，覆盖生产代码中的版本。

在测试文件myextns_test.cpp顶部添加：

// GCC/Clang 环境
#ifdef __GNUC__
bool globalVar __attribute__((weak)) = false;
// MSVC 环境
#elif _MSC_VER
__declspec(selectany) bool globalVar = false;
#endif

struct GlobalVarFixture {
    GlobalVarFixture() {
        globalVar = false;
    }
    ~GlobalVarFixture() {
        globalVar = false;
    }
};

之后同样用Fixture包裹测试用例，就能直接控制globalVar的状态，实现测试隔离。

方法3：通过内存地址强制修改（仅作为最后手段） #

如果以上方法都不可行，可以通过工具查找全局变量的内存地址，在测试中强制修改。这种方法依赖具体的编译结果，非常脆弱，只建议临时应急。

1. 编译core模块的目标文件，用nm core.o（GCC）或dumpbin /symbols core.obj（MSVC）找到globalVar的符号地址，比如输出中的000000000000000b B globalVar。
2. 在测试Fixture中通过指针修改该地址的值：

struct GlobalVarFixture {
    bool* globalVarPtr;

    GlobalVarFixture() {
        // 替换为实际查到的地址
        globalVarPtr = reinterpret_cast<bool*>(0x000000000000000b);
        *globalVarPtr = false;
    }
    ~GlobalVarFixture() {
        *globalVarPtr = false;
    }
};

方法4：重构生产代码消除全局变量（长远方案） #

全局变量本身是设计上的隐患，长远来看最好重构代码，将状态封装到类或结构体中，从根源上解决测试隔离问题。比如：

重构core.cpp：

#include "core.h"

struct CoreState {
    bool var = false;
};

int globalMethod(bool flag, CoreState& state) {
   if(flag)
   {
        state.var = true;
        return true;
   }
   return false;
}

这样每个测试用例可以创建独立的CoreState实例，完全避免状态污染。

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