通过CUPS打印机URL初始化UIPrinter失败，contactPrinter始终返回false

核心排查方向与解决方案 #

1. 确认本地网络权限配置 #

iOS 13及以上版本中，访问局域网内设备需要显式申请本地网络权限，这是导致contactPrinter(_:)返回false的常见原因：

• 在Info.plist中添加NSLocalNetworkUsageDescription键，填写权限申请说明（比如"需要访问局域网打印机进行打印"）
• 确保应用已获得用户授予的本地网络权限（可在设置→应用→你的应用→本地网络中确认）

2. 验证打印机URL的有效性 #

用终端工具测试打印机的IPP连接是否正常，排除URL或CUPS配置问题：

• 在macOS终端执行：

  ipptool -t ipps://10.1.0.2:631/printers/label_printer get-printer-attributes.test
  

• 如果命令返回打印机属性，说明URL和CUPS配置正常；如果报错，检查CUPS服务器的打印机共享设置、631端口是否开放、SSL证书是否有效（使用ipps协议时）

3. 检查CUPS服务器的AirPrint配置 #

即使打印机能被UIPrinterPickerController发现，直接通过URL创建UIPrinter仍需CUPS服务器正确配置AirPrint：

• 确保CUPS服务器开启AirPrint服务：检查/etc/cups/cupsd.conf中是否包含LoadModule airpd，并确认airpd服务正常运行
• 在CUPS网页管理界面（http://服务器IP:631）中，开启打印机的"共享"和"AirPrint"选项
• 验证打印机的IPP路径正确性：可从CUPS管理界面查看打印机的"URI"字段，确认路径与你使用的URL一致

4. 正确调用UIPrinter与打印流程 #

确保代码调用逻辑符合Apple API规范：

// 替换为你的打印机URL
guard let printerURL = URL(string: "ipps://10.1.0.2:631/printers/label_printer") else {
    print("无效的打印机URL")
    return
}

let targetPrinter = UIPrinter(url: printerURL)

// 确保在主线程触发连接操作
DispatchQueue.main.async {
    targetPrinter.contactPrinter { success in
        if success {
            // 创建打印任务
            let printInfo = UIPrintInfo(dictionary: nil)
            printInfo.outputType = .general
            printInfo.jobName = "自定义打印任务"
            
            let printController = UIPrintInteractionController.shared
            printController.printInfo = printInfo
            
            // 设置打印内容（示例为本地PDF文件）
            guard let printFileURL = Bundle.main.url(forResource: "test", withExtension: "pdf") else {
                print("找不到打印文件")
                return
            }
            printController.printingItem = printFileURL
            
            // 直接发起打印
            printController.print(to: targetPrinter, completionHandler: { _, printSuccess, error in
                if let error = error {
                    print("打印失败: \(error.localizedDescription)")
                } else if printSuccess {
                    print("打印完成")
                }
            })
        } else {
            print("无法连接到指定打印机")
        }
    }
}

5. 排除系统版本限制 #

部分iOS版本对直接初始化UIPrinter有隐性限制：

• 确保测试设备运行iOS 11及以上版本（UIPrinter(url:)从iOS 11开始支持）
• iOS 14+版本中，确认"App Tracking Transparency"设置未影响应用的本地网络访问权限

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