创建隐式链接DLL复用公共功能报LNK2005重定义错误如何解决

这个报错和“多个项目引用同一个公共DLL”没有直接关系，核心诱因是公共模块的符号被重复编译到了多个独立的二进制目标中，最终链接时出现多份同名实体。/FORCE:MULTIPLE属于强制掩盖问题的临时方案，会随机选取第一份匹配的符号参与链接，极易引发内存越界、逻辑执行异常等不可预知问题，禁止用于正式构建。

按优先级落地修复方案 #

• 优先修正公共DLL的头文件编写规范，从根源避免符号重复生成
  绝大多数这类重定义问题都是头文件违规写了实体定义导致的，严格遵循以下规则即可规避：
  1. 头文件仅保留符号声明，所有函数、类成员、全局变量的实现逻辑统一放到DLL项目对应的.cpp文件中
  2. 统一用宏切换DLL编译/外部引用的符号修饰符，避免符号被本地编译：

  // 公共功能头文件CommonFunc.h
  #ifdef COMMONFUNC_EXPORTS // DLL项目预处理器宏里定义该值，外部引用项目不定义
  #define COMMONFUNC_API __declspec(dllexport)
  #else
  #define COMMONFUNC_API __declspec(dllimport)
  #endif
  
  // 头文件仅写声明，不写实现
  COMMONFUNC_API int CalcSharedData(int input);
  class COMMONFUNC_API SharedContainer {
  public:
      void Push(int val);
  private:
      std::vector<int> storage;
  };
  

  3. 如果必须在头文件内实现轻量工具函数，必须加inline关键字修饰；全局变量在头文件中用extern声明，实体定义放到.cpp文件中。头文件保护宏（#pragma once/传统#ifndef宏）只能防止单个编译单元重复包含头文件，无法阻止多个编译单元各自生成同一份符号实体，不要指望靠头文件保护解决重定义问题。
• 排查依赖链路，避免静态重复编译公共模块
  检查报错中提到的AnotherProject项目配置，如果该项目直接把公共功能的源码加入编译、或者静态链接了公共功能的静态库版本，会把公共模块的符号直接打包进TheDLLThatUsesTheCommonFunctionallity.dll的导出lib中。最终主程序同时链接公共DLL的导入库、以及这个带公共符号的子项目lib时，就会触发重定义。
  修复规则：所有上层项目统一通过隐式链接公共DLL的导入库（CommonFunctionality.lib）调用公共功能，禁止任何子项目静态编译公共模块源码、禁止链接公共模块的静态库版本。
• 清理链接器输入配置，移除重复引用
  打开最终出问题的主项目链接器配置，检查附加依赖项列表，删除重复添加的公共lib条目；如果用VS的项目引用功能，将子项目引用属性中的“链接库依赖项”设置为否，避免IDE自动把依赖项目的输出重复追加到链接输入列表中。

验证修复效果的标准：编译所有项目后，用dumpbin命令查看各子项目生成的lib导出符号，确认公共功能的符号仅存在于CommonFunctionality.lib中，其他子项目的lib里不包含公共模块的实体符号。

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