跨编译aarch64时触发incomplete type错误，求技术解答

问题场景 #

实现hal::notifier类的Mock时，原类包含纯虚函数：

// notifier.hpp
#include <any>

namespace hal {
class notifier {
public:
    virtual void notify(const std::any& data) = 0;
    virtual ~notifier() = default;
};
}

Mock类通过Google Mock的MOCK_METHOD声明该函数：

// notifier_mock.hpp
#include <gmock/gmock.h>
#include "notifier.hpp"

class NotifierMock : public hal::notifier {
public:
    MOCK_METHOD(void, notify, (const std::any&), (override));
};

这段代码在Apple Clang下编译正常，但使用LLVM Clang交叉编译到aarch64（搭配GCC12版本的sysroot）时，出现编译错误：base class has incomplete type，错误追踪指向testing::Matcher<const std::any&>的拷贝构造检查环节。

原因分析 #

这个问题源于跨编译器/标准库环境下的类型完整性差异：

1. Apple Clang使用自家的libc标准库，而交叉编译时LLVM Clang调用的是GCC12的libstdc，两者对std::any的内部实现和前置声明处理逻辑不同。
2. Google Mock的Matcher<T>模板在实例化时，需要依赖T的完整定义。GCC12的std::any内部某些辅助类型未被充分前置声明，当LLVM Clang处理Matcher<const std::any&>时，会判定其基类类型不完整，触发编译错误。
3. 这类问题本质是编译器对模板实例化的完整性检查严格程度不同，跨库的类型定义差异会暴露这类隐藏的兼容性问题。

解决方案 #

1. 提前完整包含<any>头文件 #

在引入Google Mock头文件之前，先确保<any>被完整包含，避免std::any以不完整类型的形式被Matcher模板实例化：

// notifier_mock.hpp 调整后
#include <any>
#include <gmock/gmock.h>
#include "notifier.hpp"

class NotifierMock : public hal::notifier {
public:
    MOCK_METHOD(void, notify, (const std::any&), (override));
};

2. 显式控制模板实例化时机 #

如果提前包含头文件无效，可以尝试将Mock类的声明和实现分离，把MOCK_METHOD的实例化延迟到std::any类型完全可见之后。或者在编译选项中添加-fno-implicit-templates，手动控制模板实例化的位置。

3. 升级Google Mock版本 #

较新的Google Mock版本可能已经修复了对std::any这类标准库类型的Matcher支持问题，建议尝试升级到最新稳定版后重新编译。

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