启用反射编译时pthread_mutex_t出现声明冲突问题求助

问题信息整理 #

编译命令

g++ -std=c++26 -fmodules -fsearch-include-path bits/std.cc
g++ -std=c++26 -fmodules -freflection -c mod.cppm -o mod.o

最小复现代码

module;

#include <sys/wait.h>

export module my_module;
import std;

auto func(std::string) {}

编译器错误输出

In file included from /usr/include/sys/types.h:227,
                 from /usr/include/stdlib.h:518,
                 from /usr/include/c++/16.1.1/cstdlib:83,
                 from /usr/include/c++/16.1.1/x86_64-pc-linux-gnu/bits/stdc++.h:39,
                 from /usr/include/c++/16.1.1/bits/std.cc:26,
of module std, imported at mod.cppm:6:
/usr/include/bits/pthreadtypes.h:72:3: error: conflicting type for imported declaration ‘typedef union pthread_mutex_t pthread_mutex_t’
   72 | } pthread_mutex_t;
      |   ^~~~~~~~~~~~~~~
In file included from /usr/include/signal.h:375,
                 from /usr/include/sys/wait.h:36,
                 from mod.cppm:3:
/usr/include/bits/pthreadtypes.h:72:3: note: existing declaration ‘typedef union pthread_mutex_t pthread_mutex_t’
   72 | } pthread_mutex_t;
      |   ^~~~~~~~~~~~~~~
mod.cppm:8: confused by earlier errors, bailing out

可解决问题的修改方式

• 移除命令行的-freflection参数
• 移除func的参数
• 将参数类型改为std::int32_t或std::exception
• 删除#include <sys/wait.h>
• 用对应的#include替换import std;

问题解答 #

是否存在操作失误？

没有。你的代码和编译选项的使用完全符合C++26模块与反射特性的规范要求，问题并非由代码写法或命令行参数的错误配置导致。

是否属于GCC Bug？需要提交报告吗？

这是典型的GCC Bug，原因在于反射特性与模块系统的交互逻辑存在兼容性缺陷：
当同时启用-fmodules和-freflection时，编译器无法正确处理系统头文件的重复包含场景——pthreadtypes.h分别通过全局模块片段的sys/wait.h和导入的std模块被加载，反射特性的启用干扰了模块系统对重复声明的正常消解机制，从而触发类型冲突错误。

建议你向GCC官方提交Bug报告，提交时附上整理好的复现信息（编译命令、最小代码、错误日志、可修复的修改方式），这能帮助GCC开发团队快速定位并修复该问题。

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