distcc配置正常但cmake构建未分发到指定从机的问题排查

以下原因均基于「distcc 基础配置正常、此前同类构建可正常分发」的前提，已排除基础配置错误类问题：

一、CMake 层面触发的编译规则旁路 #

• 复用了旧构建目录，缓存未刷新：如果当前 build 目录之前执行过不带CMAKE_[C/CXX]_COMPILER_LAUNCHER参数的 cmake 配置，后续修改参数后没有清理CMakeCache.txt或删除旧缓存，CMake 会沿用之前的旧编译命令，根本不会调用 distcc，表现为完全不分发。
• 编译任务属于不受 launcher 管控的场景：比如通过ExternalProject_Add引入的第三方子工程，其自带的构建脚本会自行生成编译命令，不会继承父项目设置的 distcc 启动器配置；或是本次编译包含独立的预处理、汇编生成等特殊目标，未走标准编译流程。
• 本次开启了触发兜底的编译特性：比如启用预编译头（PCH）时，PCH 生成阶段本身不走 distcc 分发，若后续依赖 PCH 的编译命令出现路径不匹配，会自动 fallback 本地编译；或是启用统一构建（Unity Build），合并后的超大源文件若触发 distcc 临时文件大小限制，也会自动本地编译。
• CCache 前置命中缓存：如果构建链路中 CCache 作为前置启动器（比如CMAKE_C_COMPILER_LAUNCHER="ccache;distcc"），本次编译的文件命中 CCache 本地缓存，会直接返回编译结果，完全不会调用 distcc 分发。

二、distcc 本次触发了本地编译兜底逻辑 #

• 本次构建的编译参数/路径不符合分发要求：比如新增了仅本地存在的绝对路径头文件、库文件依赖，distcc 检测到远程主机无法匹配该路径时，会自动切到本地编译；或是新增了需要本地环境变量支撑的编译参数（如本地专用的--sysroot路径），远程主机无法对齐环境时也会 fallback。
• 远程主机连通性/负载临时异常：如果本次构建期间，~/.distcc/host 列表内的远程主机出现 SSH 断连、服务端口不通，或是负载超过 distcc 预设的阈值，distcc 会自动切换到本地编译，不会主动报错。
• 环境变量异常触发禁分发逻辑：如果本次构建的 shell 环境中被误加了DISTCC_DISABLE=1、DISTCC_HOSTS=""等配置，会直接禁用 distcc 的分发能力，完全走本地编译。

三、其他易混淆的场景 #

• 本次仅触发了链接阶段：distcc 本身不处理链接任务，所有链接步骤默认在本地执行，若误将链接步骤视为未分发的编译任务，会误判异常。

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