同名Async与非Async函数编译器无法区分问题排查

问题场景 #

我定义了两个功能一致的dismiss函数：一个带可选完成闭包的同步版本，一个无参数的异步版本，代码如下：

@MainActor
@objc static func dismiss(_ completion: (() -> Void)? = nil) {
    
}

@MainActor
@objc static func dismiss() async {
    
}

在异步上下文的myFunc中调用时，出现了编译器无法区分重载的问题：

@MainActor
static func myFunc() async {
  await dismiss() // 匹配异步版本，正常运行
  dismiss() // 报错："Expression is 'async' but is not marked with 'await'"
  dismiss(nil) // 匹配同步版本，正常运行
}

明明存在可通过默认参数实现无参数调用的同步版本，为何编译器会报错？是否只能通过传入nil来解决？

原因解析 #

这是Swift函数重载解析的优先级规则导致的：

• 在异步函数的上下文内部，编译器会优先匹配异步重载，即使存在带默认参数的同步版本。
• 同步版本的dismiss(_ completion:)本质是带一个参数的函数，只是参数有默认值；而异步版本是完全无参数的dismiss() async。当你调用dismiss()时，编译器首先匹配到无参数的异步版本，因此要求你添加await，不会自动回退到带默认参数的同步重载。

解决方案 #

除了传入nil，还有两种更合理的处理方式：

1. 显式指定参数标签：通过参数标签明确指向同步版本，让编译器清晰识别

dismiss(completion: nil)

2. 优化函数重载设计：
   • 如果同步版本不需要暴露给Objective-C，可以移除其@objc标记，减少编译器的重载匹配歧义
   • 直接给其中一个函数重命名，比如将异步版本改为dismissAsync()，从根源上避免重载冲突

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