C语言编译报conflicting types for 'pause'类型冲突该如何解决？

问题复现 #

编译报错信息如下：

In file included from 
netscaler/libccauth/ccauth/platform.h:28,
from netscaler/libccauth/ccauth.h:14,
from sys/ccauth/Just_Check.h:1,
from sys/nwaas/ns_nws.c:79:

include/unistd.h:357: error: conflicting types for 'pause'
sys/sys/systm.h:383: error: previous declaration of 'pause' was 
here

两个冲突的函数声明分别为：

// 定义在 include/unistd.h
int pause(void);
// 定义在 sys/sys/systm.h
int pause(const char *wmesg, int timo);

排查步骤 #

• 梳理头文件引用链路：通过报错给出的引用链，可直接定位冲突触发路径：ns_nws.c间接引入了unistd.h和systm.h两个头文件，两个文件对pause的声明签名不匹配，导致类型冲突。
• 区分两个函数的归属：unistd.h里的pause(void)是标准POSIX接口，用于挂起进程直到收到信号；systm.h里的带参pause是业务/内核自定义接口，不属于标准库范畴。
• 确认当前编译单元的实际需求：先明确ns_nws.c的代码逻辑需要调用的是哪个pause，优先保留需要的接口。

解决方法 #

• 宏隔离冲突符号
  如果不需要用到其中一个pause，可以在引入对应头文件时用宏做临时替换，避免符号冲突，示例如下（假设不需要用unistd.h的pause）：

  #define pause unistd_pause
  #include <unistd.h>
  #undef pause
  

  替换后unistd.h里的pause会被预处理为unistd_pause，不会和自定义的pause产生冲突，反过来也可以用相同逻辑处理自定义接口。
• 调整头文件引入范围
  检查platform.h中unistd.h的引入是否必要：如果platform.h本身不需要调用unistd.h的接口，直接删除该引入即可；如果只有platform.c需要用到，就把#include <unistd.h>移到.c文件中，不要放在头文件的全局范围，避免被其他文件间接引入。
• 重命名自定义接口
  如果自定义的带参pause是项目内部实现的，最彻底的解决方式是将其重命名为不冲突的名称，比如sys_pause，同步修改所有调用该函数的代码，从根源上避免后续其他编译单元也出现同类冲突。
• 限制函数作用域
  如果其中一个pause只在对应头文件的实现内部使用，不需要对外暴露，可以给函数加上static修饰，限制其作用域仅在对应编译单元内，不会对外产生符号冲突。

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