macOS 12+应用集成Thrift Swift客户端实现ping检测报错咨询

一、Thrift客户端配置报错修复 #

Client初始化报错是Thrift 0.16.0版本Swift接口与旧版官方示例不匹配导致的，按以下步骤配置即可：

• 版本对齐：确保本地生成代码用的thrift二进制版本、Xcode项目中引入的Thrift依赖版本完全一致，均为v0.16.0，版本差会直接导致生成代码接口不匹配。
• 正确初始化代码（替换示例中错误写法）：

import Thrift

// 替换为实际服务端IP/域名、端口
let transport = TSocketTransport(hostname: "你的服务端地址", port: 服务端端口, timeout: 3000)
// 0.16.0版本要求显式传入协议实例，旧示例省略该参数是核心报错原因
let binaryProto = TBinaryProtocol(on: transport)
// 替换为你的Thrift IDL中定义的服务对应的Client类，例如IDL中服务为NodeService则为NodeServiceClient
let thriftClient = try 你的服务Client(on: binaryProto)
// 提前建立连接，不要等到调用接口时再触发连接
try transport.open()

• 若提示生成的两个Swift文件找不到依赖：进入target的Build Phases -> Compile Sources，确认两个生成的.swift文件已被加入编译列表，未加入则手动拖拽添加，选择Create groups而非Create folder references。

二、状态按钮Ping逻辑实现 #

在现有菜单栏工具中新增状态按钮按以下逻辑开发：

• 先在XIB/Storyboard中添加NSButton作为状态按钮，默认设置按钮颜色为灰色，提示文本为“未检测”。
• 给按钮绑定点击事件，网络请求逻辑放在子线程执行避免卡UI，参考代码：

// 持有的Thrift客户端实例引用
private let thriftClient: 你的服务Client
private let thriftTransport: TSocketTransport

@objc func handleStatusButtonClick(_ sender: NSButton) {
    // 点击后先设置为检测中状态，禁止重复点击
    sender.isEnabled = false
    sender.contentTintColor = .systemYellow
    sender.toolTip = "正在检测Thrift服务状态"
    
    DispatchQueue.global(qos: .userInitiated).async { [weak self] in
        guard let self = self else { return }
        var isPingSuccess = false
        
        do {
            // 连接断开时先重连
            if !self.thriftTransport.isOpen {
                try self.thriftTransport.open()
            }
            // 调用服务端ping接口
            try self.thriftClient.ping()
            isPingSuccess = true
        } catch {
            print("Ping Thrift service failed: \(error)")
        }
        
        DispatchQueue.main.async {
            sender.isEnabled = true
            if isPingSuccess {
                // 响应正常设置为绿色
                sender.contentTintColor = .systemGreen
                sender.toolTip = "Thrift服务连接正常"
            } else {
                // 连接失败设置为红色
                sender.contentTintColor = .systemRed
                sender.toolTip = "Thrift服务连接失败"
            }
        }
    }
}

• 如需应用启动后自动检测状态，在applicationDidFinishLaunching回调中主动触发一次上述按钮点击逻辑即可。

三、macOS 12 + Xcode 13适配注意事项 #

• 若应用开启了App Sandbox，进入target的Signing & Capabilities页，在App Sandbox配置中勾选Outgoing Connections (Client)，否则系统会拦截Thrift的Socket出站连接，导致一直请求失败。
• 若生成的Swift代码报并发相关语法错误，进入Build Settings搜索Concurrency，将该配置项改为Minimal即可，Xcode 13自带的Swift 5.5并发语法与Thrift 0.16.0生成代码存在小兼容问题，修改后无需调整其他配置。
• Thrift v0.16.0的Swift库最低支持macOS 10.13，与你设定的macOS 12.x+目标运行系统完全兼容，无需调整部署目标版本。

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