Obj-C/Swift混合框架中模块内引入非模块化头文件报错原因咨询

我有一个Sockets框架，定义了Obj-C协议SocketResponder。我的Services框架依赖并链接该Sockets框架，且包含Obj-C和少量Swift代码。其中一个Obj-C类型NetworkTimeResponder遵循SocketResponder协议，代码如下：

// Services/NetworkTime.h
#import <Sockets/Sockets.h>
@interface NetworkTimeResponder: <SocketResponder>
…

但编译器报错：

Include of non-modular header inside framework module 'Services.NetworkTime': "...Sockets.framework/Headers/Sockets.h"

我查遍了StackOverflow相关页面，所有方案都不适用。

我猜测问题根源是：如果应用同时导入Services和Sockets框架的头文件，Sockets框架头文件中的类型会存在两个定义，可能引发冲突。但我搞不懂的是，这和AppKit导入Foundation并声明遵循NSCopying协议，而应用同时导入AppKit和Foundation的情况有什么区别？这个问题似乎只出现在模块场景中，会不会是因为我的Services框架包含少量Swift代码？我不清楚模块的本质差异及其影响，希望有人解答。

核心原因 #

这个错误的本质是模块边界的完整性问题：

• 当Services框架包含Swift代码时，Xcode会强制将其作为完整模块处理，模块要求所有引入的头文件都必须是模块化的（即被导入的框架本身要正确配置模块，包含module.modulemap文件）。
• 若Sockets框架没有正确配置模块（比如缺少module.modulemap，或者头文件未被标记为公共模块头），直接在Services的公共头文件中导入<Sockets/Sockets.h>就会触发错误——编译器认为你在模块内部引入了非模块化头，破坏了模块的封装性。

而AppKit/Foundation的情况不同：它们都是Apple官方的完整模块化框架，AppKit的模块文件中已正确声明对Foundation模块的依赖，且通过模块系统处理了头文件共享，不会出现重复定义问题。

解决步骤 #

1. 检查Sockets框架的模块配置

   • 确认Sockets框架存在module.modulemap文件，路径为Sockets.framework/Modules/module.modulemap，内容示例：

     framework module Sockets {
         umbrella header "Sockets.h"
         export *
         module * { export * }
     }
     

   • 若没有该文件，手动添加后，在Xcode的Sockets框架Build Settings -> Packaging -> Module Map File中指定文件路径。

2. 调整Services框架的头文件引入方式

   • 如果Sockets是无法修改的第三方框架，不要在Services的公共头文件（如NetworkTime.h）中直接导入<Sockets/Sockets.h>，改为：
     1. 在NetworkTime.m中导入Sockets头文件实现协议方法；
     2. 在公共头文件中用@protocol SocketResponder;做前向声明，修改后代码如下：

        // Services/NetworkTime.h
        @protocol SocketResponder;
        @interface NetworkTimeResponder: NSObject <SocketResponder>
        …
        @end
        

   • 这样既满足协议遵循的声明，又不会在公共头中引入非模块化头，避免破坏Services模块的封装。

3. 临时Workaround（不推荐长期使用）

   • 若上述方法无效，可在Services框架的Build Settings中，将Allow Non-modular Includes In Framework Modules设置为YES，允许模块内部引入非模块化头文件。

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