Qt搭配CMake使用Ninja构建时触发ninja段错误如何排查解决？

这类执行ninja -t recompact时触发的段错误，常见诱因按概率从高到低排序：

• Qt 5.15.2套件自带的Ninja版本过旧，存在二进制兼容问题。Qt 5.15.2配套的Ninja普遍为1.8.x~1.10.x的早期版本，在2022年之后发布的Linux发行版（搭载glibc 2.35及以上版本，比如Ubuntu 22.04、Fedora 36+）上运行时，会因为内存结构适配问题触发非法内存访问，recompact作为操作Ninja内部日志数据库的子命令，是这类兼容问题的高发场景。
• 构建目录下的Ninja元数据损坏。如果之前出现过构建过程强制中断、磁盘空间写满、进程异常退出的情况，会导致.ninja_log、build.ninja等元数据文件写入不完整，Ninja读取损坏的文件结构时触发段错误。
• CMake生成的构建规则存在异常。项目内自定义的CMake脚本如果存在路径转义错误、空输出规则、特殊字符未处理的问题，会生成不符合Ninja语法规范的构建文件，触发Ninja的解析bug。
• 底层硬件故障。极小概率是系统内存存在坏块、构建目录所在磁盘出现坏道，导致文件读取时访问非法内存地址。

按从易到难、成本从低到高的顺序排查：

1. 先验证Ninja二进制本身是否正常，直接在终端执行以下命令：

   /home/klaus/Qt/Tools/Ninja/ninja --version
   

   如果执行该命令时直接触发段错误，可直接判定为Qt自带Ninja的二进制兼容问题，无需做后续排查。
2. 检查构建目录元数据状态：进入报错提示的构建目录/home/klaus/Projects/build-sermonfiller-Desktop_Qt_5_15_2_GCC_64bit-Debug，查看是否存在残留的.ninja_lock锁文件，检查.ninja_log、build.ninja文件大小是否为0、是否存在乱码内容。
3. 排除元数据损坏干扰：备份构建目录后清空整个目录内容，重新执行CMake配置流程，观察问题是否复现。如果清空重配后问题消失，说明是之前的元数据损坏导致。
4. 版本替换验证：如果重配后问题依旧，安装系统源提供的Ninja版本（通常为1.11及以上稳定版），替换Qt套件自带的Ninja路径重新构建，验证问题是否消失。

根据排查到的原因对应处理：

• 针对Ninja版本兼容问题：
  优先使用系统包管理器安装最新稳定版Ninja，打开Qt Creator，在「工具-选项-Kits-构建工具」中添加系统安装的Ninja路径（通常为/usr/bin/ninja），将对应Qt 5.15.2套件的Ninja工具切换为新添加的系统版本即可。如果不想使用系统版本，也可以下载1.11及以上版本的Ninja二进制文件，直接替换/home/klaus/Qt/Tools/Ninja/ninja路径下的旧文件，注意给新二进制添加可执行权限。
• 针对构建元数据损坏问题：
  直接删除整个报错对应的构建目录，在Qt Creator中执行「构建-重新构建项目」，让CMake重新生成全部构建元数据即可，不要在已损坏的构建目录上继续做增量构建。
• 针对CMake规则异常问题：
  如果替换Ninja版本、清空构建目录后问题依旧复现，逐段排查项目内的自定义CMake逻辑，重点检查自定义命令、文件生成规则部分，确认是否存在路径含未转义特殊字符、输出路径为空、命令参数缺失的问题，通过逐段注释规则的方式定位触发异常的代码块修正即可。
• 针对硬件故障问题：
  以上方案都无效时，运行内存检测、磁盘坏道检测工具排查硬件问题。

注：-t recompact是Ninja的内置维护命令，作用是压缩清理历史构建日志，移除无效的构建记录，该流程不参与实际编译逻辑，90%以上的同类报错都是Qt自带旧版Ninja的兼容问题导致，优先替换Ninja版本即可快速解决。

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