使用MinGW64+CMake(Ninja)+SDL3编译时遭遇PCH分配失败的问题及相关技术疑问

问题概述 #

我在使用MinGW64（w64devkit）配合CMake、Ninja编译SDL3项目时，随机出现PCH分配失败的问题，即使系统主内存充足。同时对错误日志里的地址相关描述有疑问，具体细节如下：

环境配置（前置依赖） #

• CMake 3.20及以上版本
• 编译工具链：w64devkit v2.3.0（内置x86_64-w64-mingw32-gcc 15.1.0）
• Ninja生成器：对应版本已验证sha256完整性
• libSDL3：release-3.2.18源码版本
• VSCode（已安装CMake、C/C++官方扩展）

项目结构与配置 #

目录结构 #

./
├── Src/
│   └── main.cpp
├── Inc/
│   └── main.hpp
├── Lib/
│   └── SDL3/       # 解压后的SDL3源码
└── CMakeLists.txt

CMakeLists.txt配置 #

cmake_minimum_required(VERSION 3.20)
project(test CXX)
add_subdirectory(./Lib/SDL3)
add_executable(test ./Src/main.cpp)
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
target_compile_features(test PUBLIC cxx_std_17)
target_link_libraries(test PUBLIC SDL3::SDL3)

main.cpp代码 #

#include <iostream>
#include <SDL3/SDL.h>
using namespace std;

int main(){
    cout << "words" << endl;
    return 0;
}

操作步骤 #

1. 按上述结构创建目录与文件，配置好CMakeLists.txt和源码
2. 在VSCode中配置CMake：指定默认生成器为Ninja，选择w64devkit作为工具链
3. 执行CMake: Configure完成配置，再执行CMake: Debug触发编译
4. 编译过程随机卡在PCH分配环节；若编译正常，需将build/SDL3/SDL3.dll复制到test.exe同目录

关键错误日志 #

编译失败时终端输出核心错误：

internal error in mingw32_gt_pch_use_address, at config/i386/host-mingw32.cc:186:
MapViewOfFileEx: Attempt to access invalid address.
<command-line>: sorry, unimplemented: PCH allocation failure

核心疑问 #

1. 明明系统主内存充足，为什么还会出现**"PCH allocation failure"**错误？
2. 错误日志里的"MapViewOfFileEx: Attempt to access invalid address"中的地址，指的是硬盘地址还是主内存地址？

已尝试的排查手段 #

• 更换不同版本的MinGW64工具链，问题依旧
• 改用Makefile生成器替代Ninja，无改善
• 降低Ninja编译线程数（ninja -j4/ninja -j1），未解决问题
• 纯标准库的CMake项目可正常编译调试，排除工具链基础问题
• 项目在Ubuntu虚拟机、另一台Windows 11机器上均可正常运行，仅当前Windows机器出现此问题

解答与可能的解决方案 #

针对疑问的解答 #

1. PCH分配失败的原因：
   该错误并非物理内存不足导致，而是MinGW在处理预编译头（PCH）时的虚拟内存映射冲突。MinGW会尝试将PCH文件映射到进程虚拟地址空间的固定位置，若该地址被系统其他模块占用、或Windows虚拟内存页面配置异常、或安全软件拦截了内存映射操作，就会触发分配失败，且因为地址冲突的随机性，错误会随机出现。

2. 地址属性的说明：
   MapViewOfFileEx是Windows系统API，用于将硬盘文件映射到进程的虚拟内存地址空间（属于主内存的虚拟地址范畴），而非物理硬盘地址。错误中的"invalid address"指的是这个虚拟内存地址无效或已被占用，导致PCH文件无法正常映射。

可行的解决方案 #

1. 禁用PCH编译
   在CMakeLists.txt中强制关闭预编译头功能，绕过内存映射问题：

   # 全局禁用PCH
   set(CMAKE_CXX_USE_PCH OFF)
   set(CMAKE_C_USE_PCH OFF)
   # 或仅针对SDL3禁用PCH
   set_target_properties(SDL3::SDL3 PROPERTIES CXX_USE_PCH OFF)
   

2. 关闭MinGW的PCH内存映射优化
   在编译选项中添加-mno-pch-use-file-map，禁用MinGW的PCH内存映射机制，改用传统方式加载PCH：

   target_compile_options(test PRIVATE -mno-pch-use-file-map)
   target_compile_options(SDL3::SDL3 PRIVATE -mno-pch-use-file-map)
   

3. 系统层面排查

   • 检查Windows虚拟内存页面文件：设置为"系统托管"，避免手动设置的过小导致虚拟内存不足
   • 临时关闭杀毒软件/防火墙，排查是否有拦截MinGW的内存映射操作
   • 修复或更新Windows系统的VC++运行库，确保系统API调用正常

内容来源于stack exchange