Swift协议继承跨模块默认实现失效问题求助

这个问题我之前也碰到过，主要是跨模块时Swift协议扩展的查找规则、签名匹配以及访问级别的问题导致的，下面给你几个可行的解决方案：

1. 先修正协议方法的签名匹配问题 #

首先看你的MultipartUploading扩展，这里有个很容易忽略的细节：协议定义的方法是带throws的，但你写的扩展方法却没有，这就导致这个扩展并没有实现协议要求的方法，而是新增了一个同名的非抛出方法。编译器自然会认为你没有满足协议的要求，必须手动实现。

修正前的错误代码：

// 协议要求带throws
public protocol MultipartUploading {
    func multipartFormData() throws -> Data?
}

// 扩展方法没有throws，和协议签名不匹配
public extension MultipartUploading where Self: IRouter {
    func multipartFormData() -> Data? { 
        // 构建上传数据
    }
}

修正后的正确代码：

public extension MultipartUploading where Self: IRouter {
    func multipartFormData() throws -> Data? { // 加上throws，和协议签名一致
        // 构建上传数据的逻辑
    }
}

2. 把默认实现直接移到IRouter的扩展里 #

相较于给父协议加where Self: IRouter的约束扩展，直接给IRouter写扩展来实现这些方法，能让跨模块的类型更明确地获取到默认实现，避免Swift在跨模块时的扩展查找优先级问题。

替换掉原来的Requestable和MultipartUploading的约束扩展，改成这样：

public extension IRouter {
    func asURLRequest() throws -> URLRequest {
        // 构建URLRequest的逻辑
    }
    
    func multipartFormData() throws -> Data? {
        // 构建上传数据的逻辑
    }
}

这样不管是同一模块还是其他模块里定义的Router: IRouter，都会自动继承这两个方法的实现，不用再手动写了。

3. 确保所有相关代码的访问级别正确 #

跨模块使用时，访问级别是关键：

• 所有协议（IRouter、Requestable、MultipartUploading）都要标记为public
• 扩展也必须是public，否则跨模块看不到里面的默认实现
• 如果你的默认实现里用到了其他类型、方法或者属性，也要确保这些依赖的访问级别是public（跨模块必须）

4. 清理Xcode缓存，强制重新索引 #

有时候Xcode的索引会抽风，导致跨模块的协议扩展无法被正确识别。可以试试这些操作：

• 按下Cmd + Shift + K清理Build Folder
• 完全退出Xcode，再重新打开
• 先重新编译你的框架模块，再编译应用Target

为什么会出现这个问题？ #

跨模块时Swift对协议扩展的查找逻辑比同一模块严格很多：

• 签名不匹配会直接导致扩展无法覆盖协议要求的方法，编译器依然判定你未实现协议
• 父协议带where约束的扩展，在跨模块时可能因为上下文识别问题，无法被关联到遵循子协议的类型上
• 访问级别不足会让跨模块的代码看不到扩展里的默认实现

内容的提问来源于stack exchange，提问作者Michał Ziobro