这始于我在将我的小型异常处理库集成到由单个 Visual Studio 解决方案中的约 200 个 Visual C++ 项目组成的代码库时遇到的一个看似很小的问题。

我有一个链接器问题，由这样的消息表示

3>B_Utils.lib(B_Utils.dll) : error LNK2005: "public: __cdecl ExceptionBase<class std::runtime_error>::ExceptionBase<class std::runtime_error>(class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > const &)" (??0?$ExceptionBase@Vruntime_error@std@@@@QEAA@AEBV?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@@Z) already defined in TranslationUnit_2.obj
3>B_Utils.lib(B_Utils.dll) : error LNK2005: "public: virtual __cdecl ExceptionBase<class std::runtime_error>::~ExceptionBase<class std::runtime_error>(void)" (??1?$ExceptionBase@Vruntime_error@std@@@@UEAA@XZ) already defined in TranslationUnit_2.obj
3>B_Utils.lib(B_Utils.dll) : error LNK2005: "public: __cdecl ExceptionBase<class std::runtime_error>::ExceptionBase<class std::runtime_error>(class ExceptionBase<class std::runtime_error> const &)" (??0?$ExceptionBase@Vruntime_error@std@@@@QEAA@AEBV0@@Z) already defined in TranslationUnit_2.obj

乍一看，它看起来是另一个典型的问题，可以通过典型的建议“尝试更改 #include 文件的顺序”或“将实现移出头文件”来解决，但事实并非如此。

我探索了许多类似的相关问题，例如 this或 this one ，但没有一个适合我的情况。至少，建议的食谱对我的问题没有帮助。

此外，很久以前我们公司的人在迁移到VS2010的过程中遇到了另一个与Visual Studio链接器相关的问题，结果是一个链接器错误，see here .无论如何，那个都不符合我的情况。

所以这个小问题最终导致了整个小型研究。您可能会找到重现问题的详细信息和玩具示例 here at github .同时，我会尽可能简要地描述下面的情况。

导致构建失败的关键因素是:

1. 3 个项目(我们将它们命名为 A、B、C)，依赖关系图如下:B->A、C->B、C->A。
2. 在项目 A 中，我们定义了一个模板类。它在该项目 A 的标题中被实例化。
3. 项目 B 中的 DLL 导出类继承自 2) 的相同模板类实例。
4. 项目 C 具有至少两个翻译单元，其中至少一个包括 2) 和 3)。

在代码中，它看起来像这样:

A_SDK:

(ExceptionBase.h)
template<typename T>
class ExceptionBase;
--
(foo.h)
#include "ExceptionBase.h"
inline void foo() // same effect would be with template<typename T> void foo()
{
    throw ExceptionBase<std::runtime_error>("Problem");
}

B_Utils:

(Error.h)
#include "ExceptionBase.h"
#if defined(B_EXPORTS)
#define _B_UTILS_EXPORTS_CLASS      __declspec(dllexport)
#else
#define _B_UTILS_EXPORTS_CLASS      __declspec(dllimport)
#endif

struct _B_UTILS_EXPORTS_CLASS Error : public ExceptionBase<std::runtime_error>
{ Error(std::string&& s); } // ctor definition is in *.cpp file

C_Client:

(TranslationUnit_1.cpp)
#include "A_SDK/foo.h"
#include "B_Utils/Error.h"      // !!! Comment this line --> Build succeeds
void TranslationUnit_1() { 
  foo();                        // !!! Comment this line --> Build succeeds
}
(TranslationUnit_2.cpp)
#include "A_SDK/foo.h"
void TranslationUnit_2() {
  foo();                        // !!! Comment this line --> Build succeeds
}

注意那些标有//!!! 的行。评论其中的任何将使构建成功。如上所述，完整的资源可用at github .

谁能解释这里出了什么问题？ 本质上，我想了解:

• 我是否违反了这里的某些规则？
• 还是 Visual Studio 链接器问题？

附言有一种解决方法可以帮助我推进工作。参见 github's README了解详情。但是，我仍然不清楚问题的根本原因。

最佳答案

我仔细研究了您的解决方案，并且逐渐相信它也是一个编译器错误。它可以缩小到一个更小的 repro，只有 2 个二进制文件和零标准库依赖性 - 你可以检查它 here .

似乎造成困惑的关键代码是这样的——

struct BaseWithVirtual
{
    virtual void what() {}       // !!! make this non-virtual --> Build succeeds
};
    
template<typename dummy>
struct ExceptionBase : public BaseWithVirtual  {};

struct ExceptionChild : public  ExceptionBase<int> {};

inline void ThrowChild()
{
    ExceptionChild up;
    throw up;   // !!! comment this --> Build succeeds
}

这是 dropbox 链接中的 ThrowChild.h，原始等效项分布在标准库中的多个文件中 - 主要是 。

如果他们解决了这个问题，请在此处更新。

更新: 报告 3 年后，MS resolved it (rightfully) as not a bug .他们的完整答案被转储在这里，因为过去很多次我都满足于一个链接，但它已经死了。

dllimport/dllexport on a derived class needs to implicitly mark the base class as dllimport/dllexport, too. However, this can introduce ODR (one definition rule) violation as seen in your repro.

In project 'B_Utils', 'ExceptionBase' is implicitly marked as dllimport/dllexport because its derived class 'Error' is marked as dllimport/dllexport.

In project 'C_Client', the same class is not inherited and isn't marked as dllimport/dllexport.

This means when you link the two projects together you end up having two definitions of the same class and this ODR violation causes the linker error because one of its member (the copy consructor) is considered as a real function in 'C_Client' and an imported function in 'B_Utils'.

To avoid the potential ODR violation, it is better to explicitly mark the base class as dllimport/dllexport too.

This means it can be challenging to dllexport a class which derives from a class from the standard library. In this case, you may need to consider using other approaches.

Or you can add this to project 'C_Client' to avoid the ODR violation:

struct _B_UTILS_EXPORTS_CLASS DummyClassToAvoidORDViolation : public ExceptionBase {};

关于c++ - 模板类遇到 __declspec(import) 时出现 Visual Studio 链接器错误，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/45133791/