macOS菜单栏应用NSStatusItem图标随机消失问题求助

问题分析 #

你的应用在运行数小时/数天后，NSStatusItem图标随机消失，但进程仍在后台运行、全局快捷键可正常唤起窗口，结合代码和Monterey 12.2.1系统环境，核心问题可能出在以下几点：

• 错误创建了NSStatusBar实例，而非使用系统全局单例
• NSStatusItem的生命周期管理存在隐患
• macOS Monterey系统状态栏的刷新机制偶发异常

修复方案 #

1. 修正NSStatusBar的获取方式 #

NSStatusBar是系统全局单例，不应手动初始化新实例。错误创建的实例可能无法被系统正确追踪，导致图标被意外回收。

修改StatusBarController的初始化代码：

class StatusBarController {
    private let statusBar: NSStatusBar // 改为let，确保不可变
    private let statusItem: NSStatusItem
    public let popover: NSPopover
    private var eventMonitor: EventMonitor?
    
    init(_ popover: NSPopover) {
        self.popover = popover
        // 使用系统单例，而非手动初始化
        statusBar = NSStatusBar.system()
        statusItem = statusBar.statusItem(withLength: NSStatusItem.variableLength) // 推荐使用variableLength适配不同尺寸
        
        if let statusBarButton = statusItem.button {
            statusBarButton.image = #imageLiteral(resourceName: "link")
            statusBarButton.image?.size = NSSize(width: 18.0, height: 18.0)
            statusBarButton.image?.isTemplate = true
            statusBarButton.action = #selector(togglePopover(sender:))
            statusBarButton.target = self
        }
    }
    
    // 补全togglePopover实现（原代码省略部分）
    @objc func togglePopover(sender: Any?) {
        if popover.isShown {
            closePopover(sender: sender)
        } else {
            showPopover(sender: sender)
        }
    }
    
    private func showPopover(sender: Any?) {
        guard let button = statusItem.button else { return }
        popover.show(relativeTo: button.bounds, of: button, preferredEdge: .minY)
        eventMonitor = EventMonitor(mask: [.leftMouseDown, .rightMouseDown]) { [weak self] event in
            self?.closePopover(sender: sender)
        }
    }
    
    private func closePopover(sender: Any?) {
        popover.performClose(sender)
        eventMonitor?.stop()
        eventMonitor = nil
    }
}

2. 强化NSStatusItem的生命周期管理 #

确保StatusBarController实例被AppDelegate强持有，避免被意外释放。同时在应用激活时强制刷新状态栏图标，应对系统偶发的刷新异常：

修改AppDelegate代码：

@NSApplicationMain
class AppDelegate: NSObject, NSApplicationDelegate {
    let popover = NSPopover()
    var statusBar: StatusBarController?

    func applicationDidFinishLaunching(_ aNotification: Notification) {
        let contentView = ContentView()
        popover.contentViewController = MainViewController()
        popover.contentViewController?.view = NSHostingView(rootView: contentView)
        popover.animates = false
        
        KeyboardShortcuts.onKeyUp(for: .triggerPopover) { [weak self] in
            self?.statusBar?.togglePopover(sender: self)
        }
        
        statusBar = StatusBarController(popover)
    }
    
    // 应用激活时重新设置状态栏图标，修复系统刷新异常
    func applicationDidBecomeActive(_ notification: Notification) {
        guard let button = statusBar?.statusItem.button else { return }
        button.image = #imageLiteral(resourceName: "link")
        button.image?.size = NSSize(width: 18.0, height: 18.0)
        button.image?.isTemplate = true
    }
}

3. 额外排查点 #

• 检查EventMonitor的实现，确保其不会导致内存循环或意外释放状态栏相关对象
• 尝试在Info.plist中添加LSUIElement并设置为YES，确保应用以纯后台菜单栏模式运行（若你的应用不需要 Dock 图标）
• 升级到最新的macOS版本，Monterey早期版本存在状态栏相关的已知bug

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