Docker本地构建Conan包失败：CMake默认Poky工具链，找不到CustomUtils.cmake

核心原因：本地环境变量泄露至Docker容器 #

同镜像下本地构建失败的关键原因是本地环境中的CMAKE_TOOLCHAIN_FILE变量被传递到了Docker容器内，导致CMake自动加载Poky工具链文件，干扰了Conan CMakeDeps生成器的正常工作：

1. CMake工具链文件的优先级：CMake会优先读取环境变量CMAKE_TOOLCHAIN_FILE，只要该变量存在，无论命令行是否显式指定工具链，CMake都会加载对应的文件。代理环境（如CI流水线）是干净的无变量环境，而本地环境可能因之前的交叉编译操作残留了这个变量，在运行Docker时被意外传入容器。
2. Poky工具链的干扰：Poky的OEToolchainConfig.cmake会修改CMake的核心搜索路径（如CMAKE_MODULE_PATH、CMAKE_PREFIX_PATH），覆盖Conan CMakeDeps生成的配置路径，导致CMake无法找到CustomUtils.cmake以及Conan生成的目标声明文件，最终缺失CustomUtils::CustomUtils目标的日志。

验证方法 #

在本地运行的Docker容器内执行以下命令，确认环境变量是否存在：

echo $CMAKE_TOOLCHAIN_FILE

如果输出为/opt/poky/4.0.5/sysroots/x86_64-pokysdk-linux/usr/share/cmake/OEToolchainConfig.cmake，则证明变量已泄露。

解决步骤 #

1. 清除容器内的工具链环境变量：
   运行Docker时显式清除CMAKE_TOOLCHAIN_FILE变量，使用以下命令：

   # Docker 19.03+版本支持--env-unset
   docker run -it --rm --env-unset CMAKE_TOOLCHAIN_FILE -v $(pwd):/workspace your-image-name
   # 或手动设置为空值
   docker run -it --rm -e CMAKE_TOOLCHAIN_FILE= -v $(pwd):/workspace your-image-name
   

2. 清理缓存目录：
   本地的build目录如果挂载到容器内，可能残留旧的CMake缓存，导致CMake不重新读取Conan配置。先删除本地的build目录，再重新执行构建命令：

   rm -rf build
   conan install . -pr:h hprofile -pr:b bprofile -if=build
   conan build . -bf=build
   

3. 避免传递本地环境变量：
   运行Docker时不要使用--env或--env-file传递本地环境，确保容器运行在干净的环境中。

关于CMake工具链文件的环境变量控制 #

CMake的CMAKE_TOOLCHAIN_FILE是唯一控制自动加载工具链的环境变量，除此之外，系统级的CMake配置文件（如/etc/cmake.conf）或用户级配置（~/.cmake/configure）也可能影响，但同镜像下这些配置是一致的，所以核心还是环境变量的问题。

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