OpenCV调用FacemarkLBF报LNK2019外部符号未解析错误如何解决

实现人脸检测+人脸关键点检测流程时多次触发相同链接错误，未检索到公开可参考的解决信息，具体报错如下：

• Error LNK2019 external symbol not resolved "public: __cdecl cv::face::FacemarkLBF::Params::Params(void)" (??0Params@FacemarkLBF@face@cv@@QEAA@XZ)
• Error LNK2019 external symbol not resolved "public: static struct cv::Ptr<class cv::face::FacemarkLBF> __cdecl cv::face::FacemarkLBF::create(struct cv::face::FacemarkLBF::Params const &)" (?create@FacemarkLBF@face@cv@@SA?AU?$Ptr@VFacemarkLBF@face@cv@@@3@AEBUParams@123@@Z)

相关实现代码如下：

Ptr<Facemark> facemark;
CascadeClassifier faceDetector;
faceDetector.load("C:\\Users\\admin\\Documents\\Test\\haarcascade_frontalface_alt2.xml");

string LBF = "C:\\Users\\admin\\Documents\\Test\\lbfmodel.yaml";

FacemarkLBF::Params params = FacemarkLBF::Params();

facemark = FacemarkLBF::create(params);
facemark->loadModel(LBF);

cout << "Loaded Model" << endl;

已排查确认问题不存在于process函数内的检测流程调用逻辑，寻求该报错的可行解决方案。

该错误属于典型的链接阶段符号未找到错误，核心原因是cv::face::FacemarkLBF相关的实现代码没有被正确链接到项目中：FacemarkLBF不属于OpenCV默认发布的主模块内容，而是存放在opencv_contrib扩展仓库的face模块下，未正确部署该模块就会触发这类报错。

按以下优先级逐一排查即可解决：

• 确认使用的OpenCV为编译了opencv_contrib的版本：官方默认发布的预编译OpenCV包不包含contrib模块，需要自行编译OpenCV，编译时勾选contrib内的face模块，生成对应的库文件；如果使用vcpkg等包管理器安装OpenCV，需要安装带contrib特性的包，不可安装默认基础版本。
• 检查项目链接器配置：确认项目属性中附加库目录已正确指向你所用OpenCV版本的lib文件夹路径；随后在链接器-输入的附加依赖项列表中，添加对应版本的face模块库文件：Debug配置添加opencv_face{对应版本号}d.lib，Release配置添加opencv_face{对应版本号}.lib，例如OpenCV4.8.0版本Debug模式下对应库名为opencv_face480d.lib。同时要保证配置的库版本和项目当前选择的运行平台（x86/x64）、运行库类型（MT/MD/MTd/MDd）完全匹配，版本不匹配也会触发同类链接错误。
• 检查代码头文件与命名空间：代码开头需要正确引入face模块头文件#include <opencv2/face.hpp>，同时注意FacemarkLBF类位于cv::face命名空间下，不要漏写命名空间前缀，避免隐式声明导致的链接异常。

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