macOS应用调用Accessibility API获取kAXFocusedUIElementAttribute报noValue错误

核心现象 #

• 调用kAXFocusedUIElementAttribute返回AXError.noValue（错误码25212）
• 仅能识别Google Chrome和Safari的URL栏，其他应用文本框无法检测
• 启动系统自带的Accessibility Inspector后，所有设备上的应用功能恢复正常

可能的原因及修复方法 #

1. 应用激活时机过早，无障碍元素未完成初始化 #

NSWorkspace.didActivateApplicationNotification触发时，前台应用的无障碍元素可能还没完成加载，此时调用API自然拿不到值。

修复代码：
延迟150毫秒再执行焦点元素获取逻辑，给应用足够的初始化时间：

cancellable = NSWorkspace.shared.notificationCenter
    .publisher(for: NSWorkspace.didActivateApplicationNotification)
    .map { notification -> NSRunningApplication? in
        notification.userInfo?[NSWorkspace.applicationUserInfoKey] as? NSRunningApplication
    }
    .sink { [weak self] application in
        guard let app = application else { return }
        // 延迟执行等待无障碍元素就绪
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.15) {
            let focusedElement = app.processIdentifier.focussedField
            // 后续处理逻辑
        }
    }

2. 沙箱权限配置不全 #

如果你的应用开启了App Sandbox，必须配置对应权限才能访问其他应用的无障碍元素：

• 在Xcode的「Signing & Capabilities」→「App Sandbox」中，勾选Accessibility权限
• 在Info.plist中添加com.apple.security.temporary-exception.apple-events字段，允许访问目标应用（测试阶段可先用通配符*，发布时限制到必要应用）

3. 无障碍权限上下文未正确生效 #

启动Accessibility Inspector时，系统会重新加载无障碍服务，间接修复了权限上下文的问题。可以让用户手动重置权限：

• 打开系统偏好设置→辅助功能→勾选你的应用，然后取消勾选并重启应用，再重新勾选授权

4. 补充：遍历元素树兜底查找 #

如果直接获取聚焦元素失败，可以递归遍历应用的无障碍元素树，手动查找带有AXFocused属性的元素：

extension pid_t {
    var focussedField: AnyObject? {
        let axApp = AXUIElementCreateApplication(self)
        var focusedElement: AnyObject?
        let result = AXUIElementCopyAttributeValue(axApp, kAXFocusedUIElementAttribute as CFString, &focusedElement)
        
        if result == .noValue {
            // 遍历窗口树查找聚焦元素
            var windows: AnyObject?
            guard AXUIElementCopyAttributeValue(axApp, kAXWindowsAttribute as CFString, &windows) == .success,
                  let windowList = windows as? [AXUIElement] else { return nil }
            
            for window in windowList {
                if let focused = findFocusedElement(in: window) {
                    return focused
                }
            }
            return nil
        } else if result == .success {
            return focusedElement
        } else {
            logger("Failed to get focussedField \(result.rawValue)", source: .pid)
            Events.PIDExtensionFocusedFieldError(code: result.rawValue).sendEvent()
            return nil
        }
    }
    
    private func findFocusedElement(in element: AXUIElement) -> AXUIElement? {
        // 检查当前元素是否聚焦
        var isFocused: AnyObject?
        if AXUIElementCopyAttributeValue(element, kAXFocusedAttribute as CFString, &isFocused) == .success,
           let focused = isFocused as? Bool, focused {
            return element
        }
        
        // 递归查找子元素
        var children: AnyObject?
        guard AXUIElementCopyAttributeValue(element, kAXChildrenAttribute as CFString, &children) == .success,
              let childList = children as? [AXUIElement] else { return nil }
        
        for child in childList {
            if let focusedChild = findFocusedElement(in: child) {
                return focusedChild
            }
        }
        return nil
    }
}

5. 系统版本适配差异 #

不同macOS版本的无障碍API权限验证逻辑有差异（比如Ventura和Sonoma的限制更严格），确保测试设备的系统版本与开发设备一致，或针对不同版本做针对性适配。

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